POST /rest/api/2/workflows

Returns a list of workflows and related statuses by providing workflow names, workflow IDs, or project and issue types.

Permissions required:

Servers

Request headers

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

Default value: "application/json"

Query parameters

Name Type Required Description
useApprovalConfiguration Boolean No

Return the new field approvalConfiguration instead of the deprecated status properties for approval configuration.

Default value: false

expand String No

Deprecated. See the deprecation notice for details.

Use expand to include additional information in the response. This parameter accepts a comma-separated list. Expand options include:

  • workflows.usages Returns the project and issue types that each workflow is associated with.
  • statuses.usages Returns the project and issue types that each status is associated with.

Request body fields

Name Type Required Description
workflowIds[] Array No

The list of workflow IDs to query.

workflowNames[] Array No

The list of workflow names to query.

projectAndIssueTypes[] Array No

The list of projects and issue types to query.

projectAndIssueTypes[].projectId String Yes

The ID of the project.

projectAndIssueTypes[].issueTypeId String Yes

The ID of the issue type.

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.