Tasks

View Markdown

Overview

Tasks are how you create and manage media processing jobs.

Each task takes a URL as input, processes it according to the specified kind and options, and produces output files.


Task Object

task.json
{
  "id": "task_abcdefgh12345678",
  "object": "task",
  "kind": "video",
  "status": "succeeded",
  "run_id": "run_abcdefgh12345678",
  "parent_id": null,
  "progress": 100,
  "options": {
    "width": 1280,
    "height": 720,
    "format": "mp4",
    "quality": "high"
  },
  "inputs": [
    {
      "kind": "source",
      "type": "video/mp4",
      "width": 3840,
      "height": 2160,
      "url": "https://store.ittybit.net/..."
    }
  ],
  "outputs": [
    {
      "kind": "source",
      "type": "video/mp4",
      "width": 1280,
      "height": 720,
      "url": "https://store.ittybit.net/..."
    }
  ],
  "metadata": {},
  "error": null,
  "created_at": 1735689825,
  "started_at": 1735689830,
  "finished_at": 1735689886,
  "updated_at": 1735689886
}

See Tasks for detailed coverage of all available kinds, options, and statuses.


Endpoints

GET

List Tasks

POST

Create Task

GET

Get Task

On this page