latestOpenAPI 3.1.02026-08-171503582.2 MB

6199a9464227

Tasks

List all tasks

Returns a list of tasks for the given query. The tasks are returned 20 at a time, sorted in order of due date. You must use the links section to get the next 20 results.

get/tasks

Query parameters

assigneeEmailstring required

The email of the assigned user to filter the tasks by (will match in a case-insensitive manner)

workflowIdstring

The ID of the workflow to filter by.

_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

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