POST /rest/api/2/workflow/history/list
Returns a list of workflow history entries for a specified workflow id.
Note: Stored workflow data expires after 28 days. Additionally, no data from before the 30th of October 2025 is available.
Permissions required:
- Administer Jira global permission to access all, including project-scoped, workflows
- At least one of the Administer projects and View (read-only) workflow project permissions to access project-scoped workflows
Servers
- https://your-domain.atlassian.net
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 |
|---|---|---|---|
expand |
String | No |
Use expand to include additional information in the response. This parameter accepts a comma-separated list. Expand options include:
|
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
workflowId |
String | No |
The id of the workflow to read the history for. |
How to start integrating
- Add HTTP Task to your workflow definition.
- 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.
- Click Test request to test run your request to the API and see the API's response.