POST /schedules/{schedule_id}/run
Fire it now. The cadence is untouched and the overlap guard still applies.
202 rather than 201: the row exists, the agent has not run. Answering 201 with a
finished-looking body is how a caller reads a queued run as a completed one.
Name In Type Notes schedule_idpath string (uuid) required —
Status Description Body 202Successful Response RunView422Validation Error HTTPValidationError
Any operation may also answer any status in the error catalogue , and
every failure body is the platform envelope — including the 422 this document types
as HTTPValidationError.
curl -X POST https://your-deployment.example.com/schedules/{schedule_id}/run \
-H " Authorization: Bearer $COBRE_TOKEN "
Field Type Notes client_toolsend | suspendoptional Default "end". client_tool_timeout_sinteger | null optional — idstring (uuid) required — statusqueued | running | suspended | succeeded | failed | timed_out | cancelledrequired — agent_idstring (uuid) required — agent_revision_idstring (uuid) required — persona_idstring (uuid) | null optional — session_idstring (uuid) | null required , nullable— parent_run_idstring (uuid) | null required , nullable— root_run_idstring (uuid) | null required , nullable— delegation_depthinteger required — lanestring required — priorityinteger required — trigger_kindapi | schedule | event | channel | delegation | retry | replay | maintenance | systemrequired — response_modeasync | sync | callback | ackrequired — inputobject required — outputobject | null required , nullable— error_messagestring | null required , nullable— failure_classtransient | provider | tool | guardrail | budget | policy | timeout | recursion | cancelled | fatal | nullrequired , nullable— failure_detailstring | null required , nullable— attempt_countinteger required — max_attemptsinteger required — queued_atstring (date-time) required — first_started_atstring (date-time) | null required , nullable— completed_atstring (date-time) | null required , nullable— deadline_atstring (date-time) | null required , nullable— next_attempt_atstring (date-time) | null required , nullable— duration_msinteger | null required , nullable— active_msinteger required — queue_msinteger | null required , nullable— phase_timingsobject required — usageRunUsageViewoptional — correlation_idstring (uuid) | null optional — actor_credential_fingerprintstring | null optional — actor_credential_expires_atstring (date-time) | null optional — consolidation_run_idstring (uuid) | null optional — persona_namestring | null optional —