Sign in

v1

latestOpenAPI 3.0.32026-07-22194221292.5 KB
jobs

List job executions

Returns executions for a batch job. 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 keep the legacy offset/limit contract and return a bare array.

get/jobs/{jobId}/executions

Path parameters

jobIdstring required

Name of the job

Query parameters

limitinteger

Number of items per page

offsetinteger

Page offset (legacy, ignored when Blaxel-Version >= 2026-04-28)

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.

Response

successful operation

Example response

{
  "data": [
    {
      "metadata": {
        "id": "exec-abc123",
        "job": "data-processing-job",
        "workspace": "my-workspace"
      },
      "spec": {
        "memoryOverride": 2048,
        "parallelism": 5,
        "tasks": [
          {
            "metadata": {
              "name": "task-0"
            },
            "spec": {
              "maxRetries": 3,
              "timeout": "30m"
            }
          }
        ],
        "timeout": 3600
      },
      "stats": {
        "failure": 1,
        "retried": 2,
        "running": 1,
        "success": 8,
        "total": 10
      },
      "tasks": [
        {
          "metadata": {
            "name": "task-0"
          },
          "spec": {
            "maxRetries": 3,
            "timeout": "30m"
          }
        }
      ]
    }
  ]
}