ConnectCloud Developers

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:

{
  "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"

View as Markdown · Interactive reference · OpenAPI