Skip to main content
A scheduled sync ties a connector to a polling interval so that FlexOrch automatically ingests new files from your bucket without any manual action. You can create a schedule from the FlexOrch dashboard or via the API.
Scheduled Sync requires a Pro or Enterprise plan. Upgrade your plan if you do not see the Scheduler option in your settings.

​
Prerequisites

You need an active connector before creating a schedule. If you have not set one up yet, see one of the connector guides:

​
Create a schedule

1

Open the Scheduler settings

In the FlexOrch dashboard, go to Settings → Scheduler and click New Schedule.
2

Choose your connector

Select the connector that points to the bucket you want to poll. Only connectors you have already created and tested appear in the list.
3

Set a prefix (optional)

Enter a key prefix to limit polling to a specific folder within the bucket — for example, incoming/invoices/. Leave this blank to poll the entire bucket.
4

Choose a polling interval

Select how frequently FlexOrch should check for new files. Common options: 1h, 6h, 12h, 24h.
5

Enable and save

Toggle the schedule to Enabled and click Save. FlexOrch will begin polling at the next scheduled interval.

​
Create a schedule via the API

You can also create a schedule programmatically by sending a POST /v1/scheduler/schedules request. 
curl -X POST https://api.flexorch.com/v1/scheduler/schedules \
  -H "X-API-KEY: dfx_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "connector_id": 42,
    "interval": "6h",
    "prefix": "incoming/invoices/",
    "enabled": true
  }'

​
Request fields

​
connector_id
integer
required
The ID of the connector whose bucket FlexOrch will poll.
​
interval
string
required
How often FlexOrch polls for new files. Accepted values: 1h, 6h, 12h, 24h.
​
prefix
string
A key prefix that scopes polling to a specific folder within the bucket. Omit this field to poll the entire bucket.
​
enabled
boolean
Set to true to activate the schedule immediately. Defaults to true.

​
Polling intervals

IntervalBest for
1hHigh-frequency ingestion pipelines where latency matters
6hModerate-volume workflows with regular file drops
12hTwice-daily batch processing
24hEnd-of-day batch ingestion with low urgency
Use the prefix field to scope a schedule to a specific folder rather than polling an entire bucket. This reduces unnecessary API calls to your storage provider and keeps sync logs focused on the documents that matter.

​
Check sync logs

Every sync run is recorded so you can audit which files were detected and processed. To view logs:
  • Dashboard: go to Settings → Scheduler → Logs
  • API: call GET /v1/scheduler/logs, optionally filtering by schedule_id
cURL
curl https://api.flexorch.com/v1/scheduler/logs?schedule_id=sched_7f3a91bc \
  -H "X-API-KEY: dfx_your_key_here"