List Tasks

View Markdown

Get a paginated list of your tasks.


GET
/tasks

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"
kindstring
Value in: "video" | "adaptive_video" | "image" | "audio" | "speech" | "nsfw" | "summary" | "outline" | "subtitles" | "chapters" | "ingest" | "conditions" | "upload"
run_idstring
created_bystring
orderstring
Value in: "asc" | "desc"

Response Body

Default Response

responseRequiredarray<object>
[
  {
    "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
  }
]