v1

latestOpenAPI 3.0.32026-07-22194221292.5 KB

compute

List Sandbox Schedules

Returns the schedules configured on a Sandbox. Starting with API version 2026-04-28 the response is wrapped in {data, meta} and supports cursor pagination via the cursor and limit query parameters; older versions return a bare array.

get/sandboxes/{sandboxName}/schedules

Query parameters

limitinteger

Number of items per page

cursorstring

Opaque cursor returned by a previous response's meta.nextCursor. Only valid for the same query (workspace + filters); the server rejects cursors bound to a different query or older than 24h. Omit on the first page.

sort'createdAt:desc' | 'createdAt:asc' | 'name:asc' | 'name:desc'

Sort spec, formatted as <key>:<direction>. Allowed values are createdAt:desc (default), createdAt:asc, name:asc, name:desc. The cursor fingerprint is bound to the sort, so a cursor opened with one value cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.

qstring

Substring search across metadata.name, metadata.displayName and labels (keys + values). Trimmed and lowercased server-side; queries shorter than 2 characters fall back to the unfiltered listing. Bound into the cursor fingerprint so a cursor opened with one query cannot be reused with another. Only honoured starting on Blaxel-Version 2026-04-28.

type'cron' | 'at'

Filter schedules by timing type. Only cron and at are stored (sleep resolves to at on creation); any other value is ignored.

Response

successful operation

Example response

{
  "data": [
    {
      "id": "schedule-0",
      "input": {
        "command": "python train.py --epochs 10",
        "keepAlive": true,
        "name": "training-job",
        "timeout": 3600,
        "workingDir": "/app"
      },
      "maxExecutions": 100,
      "type": "cron",
      "value": "0 8 * * 1-5"
    }
  ]
}