Tasks

View Markdown

Overview

Tasks are how you create and manage your media processing jobs.

Each task takes a File or URL as input, and will output one or more Source, Track, or Intelligence files.


Task Objects

task.json
{
  "id": "task_abcdefgh1234",
  "object": "task",
  "kind": "image",
  "input": {
    "id": "file_abcdefgh1234",
    "object": "source",
    "kind": "video",
    "type": "video/mp4",
    "width": 1920,
    "height": 1080,
    "duration": 123.45,
    "filesize": 12345678,
    "url": "https://you.ittybit.net/file_abcdefgh1234",
    "ref": "original"
  },
  "options": {
    "width": 320,
    "format": "png",
    "ref": "thumbnail",
  },
  "output": {
    "id": "file_abcdefgh5678",
    "object": "source",
    "kind": "image",
    "type": "image/png",
    "width": 320,
    "height": 180,
    "filesize": 12345,
    "url": "https://you.ittybit.net/file_abcdefgh5678",
    "ref": "thumbnail",
  },
  "status": "completed",
  "created": "2025-01-01T01:23:45Z",
  "updated": "2025-01-01T01:23:46Z"
}

See Tasks for detailed coverage of all available props and values.


Endpoints

You can use the /tasks and /tasks/{id} endpoints to manage your tasks.

GET

List Tasks

POST

Create Task

GET

Get Task

On this page