Skip to navigation
API v1 ReferenceTask Statuses

Returns task statuses for the specified project.

Returns statuses relevant to the specified project. If the project is linked to a workflow, the workflow’s statuses are returned.

Required Permissions
The user must have project-master-data:read permission or be assigned to a task on the project.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

projectIdstringRequiredformat: "uuid"
The id of the project.

Query parameters

pageintegerOptionalDefaults to 1
Page number for pagination
pageSizeintegerOptionalDefaults to 10
Number of items per page
orderbystringOptional
The properties to order by
filterbystringOptional
The filter expression to filter by

Response

OK
idstringOptionalformat: "uuid"
The primary identifier of this task status.
namestring or nullOptional
The name of the task status.
typestring or nullOptional
Of what general type is this task status?.
orderdouble or nullOptional
The order of the task status in a project.
iconstring or nullOptional
The icon of the task status.
projectIdstring or nullOptionalformat: "uuid"
Is set if the task status is related to a project.
projectTypeIdstring or nullOptionalformat: "uuid"
Is set if the task status is related to a project type.
workflowIdstring or nullOptionalformat: "uuid"
Is set if the task status is related to a workflow.
createdOnstringOptionalformat: "date-time"
The date this entity was created.
createdBystringOptionalformat: "uuid"
The id of the user who created this entity.
updatedOnstringOptionalformat: "date-time"
The date this entity was last modified.
updatedBystringOptionalformat: "uuid"
The id of the user who last modified this entity.
isExternalbooleanOptional

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

Errors

401
Unauthorized Error
404
Not Found Error