Errors

The API returns a JSON body with a machine-readable code and a short message.

{
  "error": {
    "type": "invalid_request",
    "code": "schedule_invalid",
    "message": "schedule is not a valid cron expression"
  }
}

Status codes

Status	Type	Meaning
`400`	`invalid_request`	The request body or query is not valid.
`401`	`unauthorized`	Missing or invalid API key.
`403`	`forbidden`	The key lacks the required scope.
`404`	`not_found`	The job or run does not exist.
`409`	`conflict`	A job with that name already exists.
`429`	`rate_limited`	Too many requests. Retry after the `Retry-After` header.
`500`	`internal_error`	Unexpected server error.

Retry 429 and 5xx responses with exponential backoff. Do not retry 4xx responses other than 429.