List Runs

View Markdown

List all runs.


GET
/runs

Authorization

AuthorizationRequiredBearer <token>

API key authentication using "Authorization: Bearer <api_key>" header. Use your project API key (ittybit_*).

In: header

Query Parameters

afterstring
beforestring
limitstring
statusstring
Value in: "waiting" | "validating" | "queued" | "processing" | "finishing" | "succeeded" | "failed" | "cancelled"
orderstring
Value in: "asc" | "desc"

Response Body

Default Response

responseRequiredarray<object>
[
  {
    "id": "run_5xQ9wKp3vN",
    "object": "run",
    "status": "ready",
    "progress": 100,
    "tasks": [
      {
        "id": "task_2jR8kLm4nP",
        "kind": "video",
        "status": "ready",
        "progress": 100
      },
      {
        "id": "task_7mT3hYw9qR",
        "kind": "image",
        "status": "ready",
        "progress": 100
      }
    ],
    "error": null,
    "metadata": {
      "source": "api"
    },
    "created_by": "key_8bN2fXv6sL",
    "created_at": 1735689600,
    "started_at": 1735689601,
    "finished_at": 1735689615,
    "updated_at": 1735689615
  }
]