Update a schedule

Updates an existing schedule. All fields in the request body are required - this is a full update. The schedule must belong to the authenticated user’s organization.

PUT /utils/schedules/{schedule_id}

Update a schedule

cURL

curl --request PUT \
  --url https://api.example.com/utils/schedules/{schedule_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "schedule_name": "<string>",
  "schedule": {
    "type": "<string>",
    "cron": "<string>",
    "timezone": "UTC"
  },
  "reference_id": "<string>",
  "config": {
    "type": "<string>",
    "topic": "<string>",
    "extra_data": {}
  },
  "enabled": true
}
'

200

{
  "schedule_id": "<string>",
  "schedule_name": "<string>",
  "schedule": {
    "type": "<string>",
    "cron": "<string>",
    "timezone": "<string>"
  },
  "reference_id": "<string>",
  "config": {
    "type": "<string>",
    "topic": "<string>",
    "extra_data": {}
  },
  "enabled": true
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-Project-ID · string | null

Path Parameters

schedule_id · string · required

ID of the schedule to update

Body

application/json

Request body for updating a schedule.

schedule_name · string · required

Unique human readable name for the schedule

schedule · CronSchedule · object · required

Cron-based schedule configuration.

The cron expression is interpreted in the specified timezone. It will be converted to UTC for storage and execution.

CronSchedule

OneOffSchedule

Show child attributes

reference_id · string · required

Reference ID (e.g. workflow config ID) held in Data Readiness resources

config · NotificationConfig · object · required

Schedule configuration (currently only NOTIFICATION is supported)

Show child attributes

enabled · boolean · required

Whether the schedule is ready to be triggered

Response

200

application/json

Successful Response

Response body for a schedule.

Schedule values are returned in their original timezone for user-friendly display.

schedule_id · string · required

ID of the schedule

schedule_name · string · required

Unique human readable name for the schedule

schedule · CronScheduleResponse · object · required

Cron-based schedule response with timezone-aware values.

The cron expression is dynamically converted from UTC back to the original timezone specified by the user for display purposes.

CronScheduleResponse

OneOffScheduleResponse

Show child attributes

reference_id · string · required

Reference ID (e.g. workflow config ID) held in Data Readiness resources

config · NotificationConfig · object · required

Schedule configuration (currently only NOTIFICATION is supported)

Show child attributes

enabled · boolean · required

Whether the schedule is ready to be triggered