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 answerbody(string, required): Text, rendered when the task was createdcanAnswer(boolean, required): The caller is an assignee of the open taskcreatedAt(string (date-time), required): When the task was createdflowId(string (uuid), required): Id of the flowflowName(string, required): Name of the flowform(array of object, required): The fields to fill inkey(string, required): Key of the value invalueslabel(string, required): Label of the fieldtype(string, required): Input type (one oftext,longtext,number,bool,select,date)options(array of string): The choices of aselectfieldrequired(boolean): The field must be filled in
id(string (uuid), required): Task idnodeId(string, required): Id of the human_task noderunId(string (uuid), required): Id of the run that created the taskstatus(string, required): State of the task (one ofopen,completed,timed_out,cancelled)title(string, required): Title, rendered when the task was createdtype(string, required):approval(approve or reject) orform(fill in fields) (one ofapproval,form)comment(string): Comment of the answercompletedAt(string (date-time)): When the task was answered or closedcompletedBy(string): E-mail of who answereddeadlineAt(string (date-time)): Deadline of the taskoutcome(string): How the task was answered or ended (one ofapproved,rejected,completed,timeout)values(object): The submitted form values
Example 200 answer:
{
"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
curl -X GET 'https://api.mbcom.cloud/api/flows/v1/tasks/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12' \
-H "Authorization: Bearer $ACCESS_TOKEN"