SIsignificant-gravitas
v1
schedules

Create execution schedule

Changed on
post/api/graphs/{graph_id}/schedules

Request

  • The document declares no server URL.
  • Auth
    HTTP bearer

Path parameters

graph_idstring required

ID of the graph to schedule

Request body

graph_versioninteger nullable
namestring required
cronstring required
inputsobject required
credentialsobject
timezonestring nullable

User's timezone for scheduling (e.g., 'America/New_York'). If not provided, will use user's saved timezone or UTC.

expert_idstring nullable

Attribute this schedule (and every run it fires) to a hired expert owned by the caller. If omitted, resolved automatically when exactly one active hired expert has this graph installed as a workflow.

Response

Successful Response

kind'graph'
schedule_idstring nullable
user_idstring required
graph_idstring required
graph_versioninteger required
agent_namestring nullable
cronstring required
input_dataobject required
input_credentialsobject
organization_idstring
team_idstring nullable
expert_idstring nullable
idstring required
namestring required
next_run_timestring required
timezonestring

Timezone used for scheduling

Changes

  • a94489401369Revision changes
    • breaking

      the request property's minLength was increased from 0 to 1

    • breaking

      added the pattern \S to the request property

  • ae1be5efc67aRevision changes
    • warning

      added the new device_code enum value to the // response property for the response status

    • info

      added the new device_code enum value to the request property //