POST /rest/api/2/issue/{issueIdOrKey}/transitions
Performs an issue transition and, if the transition has a screen, updates the fields from the transition screen.
sortByCategory To update the fields on the transition screen, specify the fields in the fields or update parameters in the request body. Get details about the fields using Get transitions with the transitions.fields expand.
This operation can be accessed anonymously.
Permissions required:
- Browse projects and Transition issues project permission for the project that the issue is in.
- If issue-level security is configured, issue-level security permission to view the issue.
Servers
- https://your-domain.atlassian.net
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
issueIdOrKey |
String | Yes |
The ID or key of the issue. |
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 |
|---|---|---|---|
properties[] |
Array | No |
Details of issue properties to be add or update. |
properties[].key |
String | No |
The key of the property. Required on create and update. |
properties[].value |
No |
The value of the property. Required on create and update. |
|
fields |
Object | No |
List of issue screen fields to update, specifying the sub-field to update and its value for each field. This field provides a straightforward option when setting a sub-field. When multiple sub-fields or other operations are required, use |
update |
Object | No |
A Map containing the field field name and a list of operations to perform on the issue screen field. Note that fields included in here cannot be included in |
update.name |
Object | No |
Details of an operation to perform on a field. |
update.name.edit |
No |
The value to edit in the field. |
|
update.name.remove |
No |
The value to removed from the field. |
|
update.name.copy |
No |
The field value to copy from another issue. |
|
update.name.set |
No |
The value to set in the field. |
|
update.name.add |
No |
The value to add to the field. |
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.