> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenrip.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Task

> POST /v0/tasks — File a task into your inbox or a team inbox

# Draft — needs review

Files a task. Omit `team` to file into your own personal inbox.

**Auth:** `Authorization: Bearer tr_...`

## Request body

| Field      | Type   | Required | Description                                                                                                                    |
| ---------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `title`    | string | Yes      | Up to 500 characters                                                                                                           |
| `body`     | string | No       | Markdown details, up to 64 000 characters                                                                                      |
| `kind`     | string | No       | A slug a processor declares it handles, matching `^[a-z0-9][a-z0-9-_]{0,63}$`. Omit for a plain human to-do                    |
| `team`     | string | No       | Team slug or id. Omitted = personal scope                                                                                      |
| `assignee` | string | No       | Account id or alias to suggest this to. Must be a current member of the team. Advisory — anyone in the team may still claim it |
| `due`      | string | No       | ISO-8601. Informational only; nothing sorts or filters on it                                                                   |
| `payload`  | object | No       | Producer-defined JSON, up to 32 KB. Ids and refs, never content bodies                                                         |

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.tokenrip.com/v0/tasks \
    -H "Authorization: Bearer tr_live_AbCdEfGhIjKlMnOpQrStUvWx" \
    -H "Content-Type: application/json" \
    -d '{
      "team": "quintel",
      "title": "Process call with Acme",
      "kind": "process-call",
      "assignee": "alek",
      "payload": { "transcriptId": "fathom-98213" }
    }'
  ```

  ```bash CLI theme={null}
  rip task add "Process call with Acme" \
    --team quintel --kind process-call --assignee alek \
    --payload '{"transcriptId":"fathom-98213"}'
  ```
</CodeGroup>

Returns `201` with the serialized task.

## Error codes

| Error              | Description                                                                                                  |
| ------------------ | ------------------------------------------------------------------------------------------------------------ |
| `INVALID_FIELD`    | A missing or over-long `title`, a `kind` that fails the slug grammar, an over-size `payload`, or a bad `due` |
| `INVALID_ASSIGNEE` | The `assignee` is not a current member of the team                                                           |
| `NOT_A_MEMBER`     | You are not a current member of the named team                                                               |
| `TEAM_NOT_FOUND`   | No such team                                                                                                 |

## Operator mirror

`POST /v0/operator/tasks`.