## List the caller's tasks, open or done (tenant:flows:tasks, a person)

`GET /api/flows/v1/tasks`

Module: Flows · operationId: `listFlowTasks` · Tag: Tasks · Auth: access token (`Authorization: Bearer <accessToken>`)

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `status` | query | string |  | (one of `open`, `done`; default `"open"`) |
| `limit` | query | integer |  | (default `50`; max 200) |
| `cursor` | query | string |  |  |

### Responses

- **200** Tasks assigned to the caller, newest first (`application/json`)
- **400** Invalid input (`invalid`); `field` names the first invalid field, `details.fields` every one. (`application/json`)
- **401** Missing, invalid or expired token (no body).
- **403** The token lacks the permission or has no active tenant (`forbidden`). Also: `person_required` (a service-account key on personal flows or the task inbox), `live_test_forbidden`, `forbidden_grant`, `starter_excluded`. (`application/json`)

Fields of the 200 answer:

- `items` (array of Task, required): Tasks
  - `assignees` (array of string, required): E-mail addresses of the people who may answer
  - `body` (string, required): Text, rendered when the task was created
  - `canAnswer` (boolean, required): The caller is an assignee of the open task
  - `createdAt` (string (date-time), required): When the task was created
  - `flowId` (string (uuid), required): Id of the flow
  - `flowName` (string, required): Name of the flow
  - `form` (array of object, required): The fields to fill in
    - `key` (string, required): Key of the value in `values`
    - `label` (string, required): Label of the field
    - `type` (string, required): Input type (one of `text`, `longtext`, `number`, `bool`, `select`, `date`)
    - `options` (array of string): The choices of a `select` field
    - `required` (boolean): The field must be filled in
  - `id` (string (uuid), required): Task id
  - `nodeId` (string, required): Id of the human_task node
  - `runId` (string (uuid), required): Id of the run that created the task
  - `status` (string, required): State of the task (one of `open`, `completed`, `timed_out`, `cancelled`)
  - `title` (string, required): Title, rendered when the task was created
  - `type` (string, required): `approval` (approve or reject) or `form` (fill in fields) (one of `approval`, `form`)
  - `comment` (string): Comment of the answer
  - `completedAt` (string (date-time)): When the task was answered or closed
  - `completedBy` (string): E-mail of who answered
  - `deadlineAt` (string (date-time)): Deadline of the task
  - `outcome` (string): How the task was answered or ended (one of `approved`, `rejected`, `completed`, `timeout`)
  - `values` (object): The submitted form values
- `nextCursor` (string): Cursor of the next page; absent on the last page

Example 200 answer:

```json
{
  "items": [
    {
      "assignees": [
        "laura.kaestner@muster-it.example"
      ],
      "body": "Lukas Wimmer bittet um Freigabe der Bestellung für die neuen Arbeitsplätze im Vertrieb.",
      "canAnswer": true,
      "createdAt": "2026-11-18T08:14:31Z",
      "deadlineAt": "2026-11-20T16:00:00Z",
      "flowId": "2c8d4e6f-0a1b-4c3d-9e5f-7a8b9c0d1e2f",
      "flowName": "Beschaffung freigeben",
      "form": [
        {
          "key": "kostenstelle",
          "label": "Kostenstelle",
          "options": [
            "4100 Vertrieb",
            "4200 Technik"
          ],
          "required": true,
          "type": "select"
        }
      ],
      "id": "0b7e3c9a-5d1f-4a2b-8c6e-4f9a1b2c3d5e",
      "nodeId": "freigabe",
      "runId": "9a1b3c5d-7e2f-4a6b-8c0d-1e3f5a7b9c2d",
      "status": "open",
      "title": "Freigabe: 3 × Lenovo ThinkPad T14 Gen 5 (3.147,00 € netto)",
      "type": "approval"
    }
  ]
}
```

### Example request

```bash
curl -X GET 'https://api.mbcom.cloud/api/flows/v1/tasks' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
