Create workflow transition property

https://your-domain.atlassian.net/rest/api/3/workflow/transitions/{transitionId}/properties

Adds a property to a workflow transition. Transition properties are used to change the behavior of a transition. For more information, see Transition properties and Workflow properties. **Permissions required:** *Administer Jira* global permission.

Access Token Required: API Key

Path Parameters

transitionIdintegerrequired

The ID of the transition. To get the ID, view the workflow in text mode in the Jira admin settings. The ID is shown next to the transition.

Query Params

keystringrequired

The key of the property being added, also known as the name of the property. Set this to the same value as the `key` defined in the request body.

workflowNamestringrequired

The name of the workflow that the transition belongs to.

workflowModestringDefault: live

The workflow status. Set to *live* for inactive workflows or *draft* for draft workflows. Active workflows cannot be edited.

Allowed:

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request POST \
2     --url 'https://your-domain.atlassian.net/rest/api/3/workflow/transitions/{transitionId}/properties' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}

POST