Set Datasource Custom Default Run Times

When custom run times are used:

• Default runs will not run for the datasource

• Changes will take effect on the next day

• Syncs through the API are not allowed until migration from all force sync apps are completed. The sync endpoint will return an error if customRunHours is set

• The input is expected to be in client’s timezone

Limitations

When setting up your datasource’s run schedule, keep these in mind:

• No runs between 12:00 AM and 4:59 AM — these times aren’t allowed.

• Maximum of 4 runs per hour — for example: 7, 7:15, 7:30, 7:45 is fine, but you can’t schedule more than four within the same hour.

• Use proper time formats — only use HH or HH:MM in 24-hour (military) time.

• You cannot set custom schedules when using Real-Time schedule

Additional considerations:

• These may lead to data latency issues, especially if not configured thoughtfully, we recommend going through the platforms documentation to ensure this does not happen

• Users should not add more run times as workaround for temporary issues, if users choose to do so, they should remove the added run times after the issue is fixed

Migrate from Force Sync Apps

To migrate from force sync apps, we recommend using a script to configure your datasource's run schedule via the Alli Data edit endpoint.

You'll need the following:

• Datasource IDs

• Scheduled run hours

Example Request Body:

{   
  "customRunHours": ["7", "8:30", "14"] 
} 

If you're currently triggering runs through workflows or automation, make sure to remove those as part of this migration. If not removed, your workflows will error out

Example Script:

import sys, requests

token = sys.argv[1]
headers = {"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
datasources = ["datasource1", "datasource2", "datasource3"]
customSchedule = ["8", "9", "10"]

for ds in datasources:
    r = requests.patch(
        f"https://your-api-base-url.com/api/v2/datasource/{ds}/edit",
        json={"customRunHours": customSchedule},
        headers=headers
    )
    print(f"[✓] {ds}" if r.ok else f"[✗] {ds}: {r.status_code}")

Setting Custom Run Times Through the UI

To update run times manually:

1. Go to your Datasource Settings page.

2. Under Advanced Settings.

3. Look for the Custom Run Hours input — if it's empty, the datasource is currently using the default schedule.

4. Enter your custom run times (in 24-hour format) – Invalid run times will display a warning.

5. Click Save to apply the changes.