Schedules

Get schedule run

Read a Run. Schedule Run reads are read-only; status advances in the background.

get/v1/schedules/{schedule_id}/runs/{run_id}

Request

  • Base URL: https://api.sandbase.ai
  • URL: https://api.sandbase.ai/v1/schedules/{schedule_id}/runs/{run_id}
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Response

Run

idstring required

Run ID. Treat as opaque.

source_type'service' | 'schedule' required
source_idstring required
source_versioninteger required
agent_idstring required
agent_versioninteger required
trigger_source'manual' | 'scheduled' required
scheduled_atstring date-time
status'pending' | 'succeeded' | 'failed' | 'cancelled' | 'skipped' required

skipped is used when a scheduled tick finds a pending Run.

session_idstring nullable required

Session created for this Run; null until the Session exists.

error_codestring

For example session_creation_rejected, execution_failed, schedule_configuration_invalid, concurrency_limit (skipped ticks), or an admission code such as spending_limit_exceeded.

created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.