workflows

Returns task statuses of the workflow.

Changed on

Returns task statuses of the workflow. The result includes statuses configured for the workflow. <Check title="Required Permissions" icon="key">The user must either have project-master-data:read permissions for a linked project, be assigned to a non-deleted task in a linked project, be allowed to see the external workflow, or have admin / project-manage-config:read permissions.</Check>

get/workflows/{workflowId}/taskstatuses

Request

  • Base URL: https://api.awork.com/api/v1
  • URL: https://api.awork.com/api/v1/workflows/{workflowId}/taskstatuses
  • Auth: HTTP bearer

Path parameters

workflowIdstring uuid required

Query parameters

pageinteger

Page number for pagination

pageSizeinteger

Number of items per page

orderbystring

The properties to order by

filterbystring

The filter expression to filter by

Response

OK

idstring uuid

The primary identifier of this task status.

namestring nullable

The name of the task status.

typestring nullable

Of what general type is this task status?.

ordernumber double nullable

The order of the task status in a project.

iconstring nullable

The icon of the task status.

projectIdstring uuid nullable

Is set if the task status is related to a project.

projectTypeIdstring uuid nullable

Is set if the task status is related to a project type.

workflowIdstring uuid nullable

Is set if the task status is related to a workflow.

createdOnstring date-time

The date this entity was created.

createdBystring uuid

The id of the user who created this entity.

updatedOnstring date-time

The date this entity was last modified.

updatedBystring uuid

The id of the user who last modified this entity.

isExternalboolean

True if the task status is coming from an external workspace (awork Connect).

Changes

  • 1556e0487867Revision changes
    • warning

      deleted the header request parameter Authorization

    • info

      the endpoint scheme security oauth2 was added to the API

  • 8e46cf415581Revision changes
    • info

      api operation id GetWorkflowTaskStatusesByWorkflowId removed and replaced with workflows_GetWorkflowTaskStatusesByWorkflowId