v1

latestOpenAPI 3.1.0MIT2026-08-0481194343.8 KB
schedules

Get a single run

Scope: schedules:read. A run absent from this schedule returns 404 RUN_NOT_FOUND; a store outage returns 503 DB_UNAVAILABLE with Retry-After. Neither surfaces as a bare 500.

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

Response

Run.

idstring required
schedule_idstring required
status'queued' | 'running' | 'completed' | 'failed' | 'skipped' | 'cancelled' | 'insufficient_credits' required
trigger'cron' | 'manual' | 'triggered' | 'webhook' | 'email' | 'run_at' required
duration_secondsinteger nullable
credits_chargedinteger nullable

Consumer subscription-credit quota units charged for scheduled execution, not Developer API wallet cents. Zero for test, Unlimited-bypass, and other non-billable runs; no fixed USD conversion.

errorstring nullable
executed_atstring date-time required