Create Schedule

Create a new schedule for recurring workflow execution for an agent.

agent_idstring required

Request body

cron_expressionstring nullable

Cron expression for scheduling (e.g., '0 0 * * 0' for weekly on Sunday)

end_atstring date-time nullable

When the schedule should stop being active

execution_timeout_secondsinteger nullable

Maximum time in seconds for each workflow execution

interval_secondsinteger nullable

Alternative to cron - run every N seconds

namestring required

Human-readable name for the schedule (e.g., 'weekly-profiling'). Will be combined with agent_id to form the full schedule_id.

pausedboolean

Whether to create the schedule in a paused state

start_atstring date-time nullable

When the schedule should start being active

task_queuestring required

Temporal task queue where the agent's worker is listening

workflow_namestring required

Name of the Temporal workflow to execute (e.g., 'sae-orchestrator')

workflow_paramsobject nullable

Parameters to pass to the workflow

Successful Response

agent_idstring required

ID of the agent this schedule belongs to

created_atstring date-time nullable

When the schedule was created

last_action_timestring date-time nullable

When the schedule last executed

namestring required

Human-readable name for the schedule

next_action_timesstring[]

Upcoming scheduled execution times

num_actions_missedinteger

Number of scheduled executions that were missed

num_actions_takeninteger

Number of times the schedule has executed

schedule_idstring required

Unique identifier for the schedule

state'ACTIVE' | 'PAUSED' required

Schedule state enum