POST /rest/api/2/statuses

Creates statuses for a global or project scope.

Permissions required:

Servers

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
scope Object Yes

The scope of the status.

scope.type String Yes

The scope of the status. GLOBAL for company-managed projects and PROJECT for team-managed projects.

Possible values:

  • "GLOBAL"
  • "PROJECT"
scope.project Object No

Project ID details.

scope.project.id String Yes

The ID of the project.

statuses[] Array Yes

Details of the statuses being created.

statuses[].name String Yes

The name of the status.

statuses[].description String No

The description of the status.

statuses[].statusCategory String Yes

The category of the status.

Possible values:

  • "TODO"
  • "DONE"
  • "IN_PROGRESS"

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.