Transition issue - JIRA 7.6.1

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.

curl --location --request POST 'http://jira.local:8080/jira/rest//rest/api/3/issue//transitions' \ --header 'Content-Type: application/json' \ --data-raw '{ "fields": { "assignee": { "name": "bob" }, "resolution": { "name": "Fixed" } }, "historyMetadata": { "activityDescription": "Complete order processing", "actor": { "avatarUrl": "http://mysystem/avatar/tony.jpg", "displayName": "Tony", "id": "tony", "type": "mysystem-user", "url": "http://mysystem/users/tony" }, "cause": { "id": "myevent", "type": "mysystem-event" }, "description": "From the order testing process", "extraData": { "Iteration": "10a", "Step": "4" }, "generator": { "id": "mysystem-1", "type": "mysystem-application" }, "type": "myplugin:type" }, "transition": { "id": "5" }, "update": { "comment": [ { "add": { "body": { "content": [ { "content": [ { "text": "Bug has been fixed", "type": "text" } ], "type": "paragraph" } ], "type": "doc", "version": 1 } } } ] } }'

Request

Path Params

issueIdOrKey

string

required

The ID or key of the issue.

Body Params application/json

Details of an issue update request.

fields

object

optional

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. Fields included in here cannot be included in update.

Additional properties

integer | number | string | boolean

optional

historyMetadata

object

optional

Additional issue history details.

activityDescription

string

optional

The activity described in the history record.

activityDescriptionKey

string

optional

The key of the activity described in the history record.

actor

object

optional

Details of the user whose action created the history record.

cause

object

optional

Details of the cause that triggered the creation the history record.

description

string

optional

The description of the history record.

descriptionKey

string

optional

The description key of the history record.

emailDescription

string

optional

The description of the email address associated the history record.

emailDescriptionKey

string

optional

The description key of the email address associated the history record.

extraData

object

optional

Additional arbitrary information about the history record.

generator

object

optional

Details of the system that generated the history record.

type

string

optional

The type of the history record.

Additional properties

integer | number | string | boolean

optional

properties

array[object (EntityProperty) {2}]

optional

Details of issue properties to be add or update.

key

string

optional

The key of the property. Required on create and update.

value

optional

The value of the property. Required on create and update.

transition

object

optional

Details of a transition. Required when performing a transition, optional when creating or editing an issue.

string

optional

The ID of the issue transition. Required when specifying a transition to undertake.

looped

boolean

optional

Additional properties

integer | number | string | boolean

optional

update

object

optional

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 fields.

Additional properties

array[object (FieldUpdateOperation) {5}]

optional

Additional properties

integer | number | string | boolean

optional

Examples

Responses

🟢204Returned if the request is successful.

application/json

Body

No schema defined

🟠400Returned if: * no transition is specified. * the user does not have permission to transition the issue. * a field that isn't included on the transition screen is defined in `fields` or `update`. * a field is specified in both `fields` and `update

🟠401Returned if the authentication credentials are incorrect or missing.

🟠404Returned if the issue is not found or the user does not have permission to view it.