## Get a task (its assignees; read-only for whoever sees the run) (tenant:flows:tasks, a person)

`GET /api/flows/v1/tasks/{id}`

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

Besides its assignees a task is read by the owner of a personal flow, by flows admins for a tenant flow and,
for a scoped flow, by whoever its module lets manage the scope (asked only for a caller who is no assignee:
`503 scope_unavailable` when the module cannot answer).

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string (uuid) | yes |  |

### Responses

- **200** The task (`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`)
- **404** The record does not exist in the token's tenant – or it belongs to a scope the caller may not view (a scoped flow stays hidden). (`application/json`)
- **503** A dependency is not available: `scope_unavailable` (the module that owns a flow's scope did not answer who may see and manage it – nothing of a scoped flow is shown or changed), `identity_unavailable` (HR), `ai_unavailable`, `ai_failed`. (`application/json`)

Fields of the 200 answer:

- `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

Example 200 answer:

```json
{
  "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/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
