> ## 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.

# List Tasks

> GET /v0/tasks — List tasks in your inbox or a team inbox

# Draft — needs review

Lists tasks. The default view is **`mine`**: your personal tasks, plus team tasks suggested to you or claimed by you. Pass `team` to see every task in a team you belong to.

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

## Query parameters

| Parameter  | Type    | Required | Description                                                                             |
| ---------- | ------- | -------- | --------------------------------------------------------------------------------------- |
| `team`     | string  | No       | Team slug or id. Switches to every task in that team                                    |
| `status`   | string  | No       | Comma list of `open`, `claimed`, `done`, `dismissed` — or `all`. Default `open,claimed` |
| `kind`     | string  | No       | Only tasks of this kind. Must match `^[a-z0-9][a-z0-9-_]{0,63}$`                        |
| `assignee` | string  | No       | Only `me` is accepted — tasks suggested to or claimed by you                            |
| `since`    | string  | No       | ISO-8601 timestamp, or a positive number of days back (≤ 36500)                         |
| `limit`    | integer | No       | 1–200. Default `50`                                                                     |
| `cursor`   | string  | No       | `nextCursor` from a previous page. Opaque                                               |

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.tokenrip.com/v0/tasks?team=quintel&status=open&kind=process-call" \
    -H "Authorization: Bearer tr_live_AbCdEfGhIjKlMnOpQrStUvWx"
  ```

  ```bash CLI theme={null}
  rip task list --team quintel --status open --kind process-call
  ```
</CodeGroup>

Results are newest-first by creation time. Nothing sorts or filters on `dueAt` — it is stored and returned for the caller's benefit only.

List rows are lean: they do **not** carry `processors[]` or the task body. Use [Get Task](/api-reference/tasks/get) for those.

## Error codes

| Error            | Description                                                                                                                    |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `INVALID_FIELD`  | A bad `status`, `kind`, `assignee`, `since` or `limit`. `since=0`, a negative value and a unix timestamp are all rejected here |
| `INVALID_CURSOR` | The cursor is malformed. It is opaque — re-run the query rather than editing it                                                |
| `NOT_A_MEMBER`   | You are not a current member of the named team                                                                                 |
| `TEAM_NOT_FOUND` | No such team                                                                                                                   |

## Operator mirror

`GET /v0/operator/tasks` — the same surface with an operator session, resolving the bound account.