ConnectCloud Developers

List the open tasks assigned to the caller (tenant:access)

GET /api/workflow/v1/tasks

Module: Workflow · operationId: listTasks · Tag: Tasks · Auth: access token (Authorization: Bearer <accessToken>)

Instances in state OPEN or RETRYING_SYNC whose current step is assigned to the caller (the step's user, a member of its group, or the recipient or sender of an open inquiry). Each item carries the blueprint's overview fields with their values. Pages with limit and offset; total counts all open tasks of the caller.

Parameters

Name In Type Required Description
limit query integer Page size; another value than 1–500 is a 400 invalid (default 100; max 500)
offset query integer Number of items to skip; a negative value is a 400 invalid (default 0)
slim query string true or 1: return SlimTaskListItems without data and history (one of true, 1)
format query string slim: same as slim=true (one of slim)
slim_history query string true or 1: blank the comments of notes and of history entries longer than 100 characters (one of true, 1)

Responses

  • 200 Tasks (slim items when slim is set) (application/json)
  • 400 Error (application/json)
  • 401 Missing or invalid token (unauthorized) (application/json)
  • 403 Error (application/json)
  • 500 Error (application/json)

Fields of the 200 answer:

  • items (array of TaskListItem | SlimTaskListItem, required): Tasks of the page
  • total (integer, required): Number of open tasks of the caller

Example 200 answer:

{
  "items": [
    {
      "blueprint": {
        "id": "er-freigabe",
        "version": 3
      },
      "blueprintId": "er-freigabe",
      "blueprintVersion": 3,
      "claimedAt": "2026-11-17T09:05:40Z",
      "claimedBy": "christina.adler@muster-it.example",
      "currentStep": {
        "allowInquiry": true,
        "fields": [
          {
            "label": "Eingangsnr.",
            "name": "transactionNumber"
          },
          {
            "label": "Rechnungsnummer",
            "name": "externalTransactionNumber"
          },
          {
            "label": "Lieferant",
            "name": "partnerCompany"
          },
          {
            "editable": true,
            "label": "Fällig am",
            "name": "dueDate"
          },
          {
            "label": "Brutto",
            "name": "grossTotal"
          },
          {
            "label": "Bezeichnung",
            "name": "lines.name"
          },
          {
            "editable": true,
            "label": "Kostenstelle",
            "name": "lines.lineData.costCenter",
            "required": true
          },
          {
            "label": "Menge",
            "name": "lines.quantity"
          }
        ],
        "group": "4e7a1c2b-9f3d-4b8a-a6e1-5c0d2f8b3a71",
        "lines": {
          "allowDelete": true,
          "allowDuplicate": true
        },
        "name": "kontierung",
        "nextSteps": [
          {
            "color": "primary",
            "icon": "i-lucide-arrow-right",
            "label": "Weiter zur Freigabe",
            "step": "freigabe"
          },
          {
            "color": "error",
            "icon": "i-lucide-x-circle",
            "label": "Ablehnen",
            "step": "abgelehnt"
          }
        ],
        "notifyAssigneesByEmail": true,
        "stepType": "UserStep"
      },
      "customerId": {
        "customerId": "99999",
        "tenantName": "DEMO"
      },
      "guid": "3f9c2a1e-8b7d-4c6e-a5f4-1d2b3c4e5f60",
      "objectNumber": "ER-2026-00042",
      "objectType": "transaction",
      "overviewField1": {
        "label": "Lieferant",
        "name": "partnerCompany",
        "value": "Nordlicht IT-Distribution GmbH"
      },
      "overviewField2": {
        "label": "Brutto",
        "name": "grossTotal",
        "value": "6911.52"
      },
      "startTime": "2026-11-17T08:41:12Z",
      "workflowState": "OPEN"
    }
  ],
  "total": 1
}

Example request

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

View as Markdown · Interactive reference · OpenAPI