Create Run

View Markdown

Create a new run with one or more tasks.


POST
/runs

Authorization

AuthorizationRequiredBearer <token>

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

In: header

Request Body

application/jsonRequired
tasksRequiredarray<object>
metadataobject
idempotency_keystring

Response Body

Default Response

idRequiredstring
objectRequiredstring
Value in: "run"
statusRequiredstring
progressRequirednumber
tasksRequiredarray<object>
errorobject
metadataobject
created_bystring
created_atRequirednumber
started_atRequirednumber
finished_atRequirednumber
updated_atRequirednumber
[key: string]any
{
  "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
}