# Create Task

[View original](https://ittybit.com/api/tasks/create)


`POST /tasks`

Creates a new task item. See [Tasks](/docs/tasks) for detailed coverage of all available props and values.

### Request Body

The request body should contain a properly formatted JSON object with one of `url` or `file_id`, plus a `kind`. See [Tasks](/docs/tasks) for more details.

**Schema:**

```json
{
  "type": "object",
  "required": [
    "kind"
  ],
  "oneOf": [
    {
      "required": [
        "url"
      ]
    },
    {
      "required": [
        "file_id"
      ]
    }
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri"
    },
    "file_id": {
      "type": "string",
      "example": "file_abcdefgh1234"
    },
    "kind": {
      "type": "string",
      "enum": [
        "ingest",
        "video",
        "image",
        "audio",
        "chapters",
        "subtitles",
        "thumbnails",
        "nsfw",
        "speech",
        "description",
        "outline",
        "prompt",
        "workflow",
        "conditions",
        "http"
      ]
    },
    "filename": {
      "type": "string"
    },
    "folder": {
      "type": "string"
    },
    "ref": {
      "type": "string"
    },
    "webhook_url": {
      "type": "string",
      "format": "uri"
    }
  }
}
```

**Example:**

```json
{
  "file_id": "file_abcdefgh1234",
  "kind": "image",
  "width": 320,
  "format": "png",
  "ref": "thumbnail"
}
```

### Responses

#### 201 - Success

**Example:**

```json
{
  "meta": {
    "request_id": "req_abcdefghij1234567890",
    "org_id": "org_abcdefgh1234",
    "project_id": "prj_abcdefgh1234",
    "version": "2025-01-01",
    "type": "object"
  },
  "data": {
    "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": null,
    "status": "pending",
    "created": "2025-01-01T01:23:45Z",
    "updated": "2025-01-01T01:23:45Z"
  },
  "links": {
    "self": "https://api.ittybit.com/tasks/task_abcdefgh1234",
    "parent": "https://api.ittybit.com/tasks"
  }
}
```