latestOpenAPI 3.1.02026-08-171503582.2 MB

6199a9464227

Workflow Tasks

List workflow tasks

Returns a paginated list of workflow tasks for a workflow revision, ordered by position.

get/workflows/{workflowId}/revisions/{revisionId}/tasks

Path parameters

workflowIdstring required

The ID of the Workflow

revisionIdstring required

The ID of the Revision

Query parameters

taskType'Standard' | 'Approval' | 'AI' | 'Code'

What the task does.

  • Standard — a regular task that a user manually checks off when done.
  • Approval — an approval task; a reviewer approves or rejects it, gating subsequent tasks.
  • AI — an automated task that runs an AI prompt to populate form field values.
  • Code — an automated task that runs a custom code snippet.

Filter by task type: Standard, Approval, AI, or Code.

_string

Opaque pagination cursor. Take this value from the previous response's links[] entry whose name is "next" (typically just follow that link's href instead of reading this value). Omit on the first page. If the previous response had no next link, there are no more pages.

Response

Example response

{
  "data": [
    {
      "audit": {
        "createdBy": {
          "id": "naAJxoDIuwdgNsQHGRRGqA",
          "email": "jane.doe@example.com",
          "username": "Jane Doe"
        },
        "updatedBy": {
          "id": "naAJxoDIuwdgNsQHGRRGqA",
          "email": "jane.doe@example.com",
          "username": "Jane Doe"
        }
      },
      "links": [
        {
          "href": "https://api.process.st/api/v1.1/resource/XXX"
        }
      ]
    }
  ],
  "links": [
    {
      "href": "https://api.process.st/api/v1.1/resource/XXX"
    }
  ]
}