Transition issue

POST

/rest/api/3/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.

Request

Path Params

Body Params application/json

Examples

Responses

🟢204No Content

application/json

Returned if the request is successful.

Body

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🟠409409

🟠413413

🟠422Parameter Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/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
                    }
                }
            }
        ]
    }
}'

Response Example

null

Modified at 2025-07-16 07:18:01

Get transitions

Export archived issue(s)