Skip to main content
PUT
/
api
/
v1
/
workflow
/
public
/
scheduled
/
:schedule_id
curl -X PUT "https://app.refold.ai/api/v1/workflow/public/scheduled/{schedule_id}" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "trigger_type": "cron",
    "regex": "0 10 * * 1",
    "tz": "UTC"
  }'
{
  "_id": "6a315b7ad396207fd2547678",
  "event_id": "6a315b7ad396207fd2547676",
  "workflow": "6a17f312aae660322b26883e",
  "config_id": "user_12345",
  "linked_account_id": "user_12345",
  "trigger_type": "cron",
  "cron_patten": "0 10 * * 1",
  "status": "running",
  "inactive": false,
  "registered_by_api": true,
  "options": { "startDate": "2026-07-01", "tz": "UTC", "trigger_type": "cron" }
}
Update an existing schedule — change its cron expression, interval dates, date window, timezone, or payload. Returns the updated schedule.

Authentication

x-api-key
string
required
Your Refold API key.
linked_account_id
string
required
The linked account that owns the schedule.

Path Parameters

schedule_id
string
required
The schedule ID.

Body Parameters

trigger_type
string
cron or interval.
regex
string
Cron expression (cron schedules). Stored as cron_patten.
interval_dates
array
Interval date objects (interval schedules).
startDate
string
Earliest run date (YYYY-MM-DD).
endDate
string
Latest run date (YYYY-MM-DD).
tz
string
Timezone.
payload
object
Event payload passed to the workflow.

Response

Returns the updated schedule (same shape as Register Schedule).
{
  "_id": "6a315b7ad396207fd2547678",
  "event_id": "6a315b7ad396207fd2547676",
  "workflow": "6a17f312aae660322b26883e",
  "config_id": "user_12345",
  "linked_account_id": "user_12345",
  "trigger_type": "cron",
  "cron_patten": "0 10 * * 1",
  "status": "running",
  "inactive": false,
  "registered_by_api": true,
  "options": { "startDate": "2026-07-01", "tz": "UTC", "trigger_type": "cron" }
}
curl -X PUT "https://app.refold.ai/api/v1/workflow/public/scheduled/{schedule_id}" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "trigger_type": "cron",
    "regex": "0 10 * * 1",
    "tz": "UTC"
  }'