Get Task

View Markdown

Get a task by ID.


GET
/tasks/{id}

Authorization

AuthorizationRequiredBearer <token>

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

In: header

Path Parameters

idRequiredstring

Response Body

Default Response

idRequiredstring
objectRequiredstring
Value in: "task"
kindRequiredstring
statusRequiredstring
progressRequirednumber
inputobject
outputobject
errorobject
metadataobject
created_bystring
created_atRequirednumber
started_atRequirednumber
finished_atRequirednumber
updated_atRequirednumber
[key: string]any
{
  "id": "task_2jR8kLm4nP",
  "object": "task",
  "kind": "video",
  "status": "ready",
  "progress": 100,
  "input": {
    "kind": "url",
    "url": "https://storage.example.com/uploads/interview.mov",
    "filename": "interview.mov",
    "filesize": 52428800,
    "mimetype": "video/quicktime",
    "width": 1920,
    "height": 1080,
    "duration": 124.5,
    "bitrate": 3370000,
    "framerate": 30,
    "codecs": {
      "video": {
        "name": "h264",
        "profile": "high",
        "level": "4.0"
      },
      "audio": {
        "name": "aac",
        "sample_rate": 48000,
        "channels": 2,
        "bitrate": 128000
      }
    }
  },
  "output": {
    "kind": "internal",
    "url": "https://cdn.ittybit.com/proj_abc/task_2jR8kLm4nP/interview.mp4",
    "filename": "interview.mp4",
    "filesize": 18874368,
    "mimetype": "video/mp4",
    "width": 1280,
    "height": 720,
    "duration": 124.5,
    "bitrate": 1200000,
    "framerate": 30
  },
  "error": null,
  "metadata": null,
  "created_by": "run_5xQ9wKp3vN",
  "created_at": 1735689600,
  "started_at": 1735689601,
  "finished_at": 1735689615,
  "updated_at": 1735689615
}