latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-21340457963.9 KB

2f82328f5184

v1
schedules

Create execution schedule

post/api/graphs/{graph_id}/schedules

Path parameters

graph_idstring required

ID of the graph to schedule

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