projectStatuses

Creates a status for the specified project.

Changed on

Creates a project status. Projects linked to a workflow must manage statuses through that workflow. <Check title="Required Permissions" icon="key">The user must be the project owner or have project-manage-config:write permission.</Check>

post/projects/{projectId}/projectstatuses

Request

  • Base URL: https://api.awork.com/api/v1
  • URL: https://api.awork.com/api/v1/projects/{projectId}/projectstatuses
  • Auth: HTTP bearer

Path parameters

projectIdstring uuid required

The id of the project.

Request body

namestring required

The name of the project status.

typestring required

Specifies the general type of this project status. Accepted values: 'progress', 'not-started', 'closed', 'stuck

Response

OK

idstring uuid

The primary identifier of this project status.

namestring nullable

The name of the project status.

typestring nullable

The general type of this project status.

isArchivedboolean

Indicates whether this status is archived.

orderinteger nullable

The order of this status.

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.

projectTemplateIdstring uuid nullable

The id of the project template of the status.

projectIdstring uuid nullable

The id of the project the status belongs to.

workflowIdstring uuid nullable

The id of the workflow linked to this project status.

updatedBystring uuid

The id of the user who last modified this entity.

isExternalboolean

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

Changes