Cloud
Jira Cloud platform / Reference / REST API v3

Workflow transition properties

This resource represents workflow transition properties, which provides for storing custom data against a workflow transition. Use it to get, create, and delete workflow transition properties as well as get a list of property keys for a workflow transition. Workflow transition properties are a type of entity property.

GET

Get workflow transition properties

Returns the properties on 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.

Data Security Policy: Exempt from app access rules
Scopes
ClassicRECOMMENDED:manage:jira-configuration
Granular:read:workflow.property:jira

Connect app scope requiredADMIN

Request

Path parameters

transitionId

integer

Required

Query parameters

includeReservedKeys

boolean

key

string

workflowName

string

Required
workflowMode

string

Responses

200 response

application/json

WorkflowTransitionProperty

Details about the server Jira is running on.

GET/rest/api/3/workflow/transitions/{transitionId}/properties
1 2 3 4 5 6 7 8 9 10 11 12 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; const response = await api.asUser().requestJira(route`/rest/api/3/workflow/transitions/{transitionId}/properties?workflowName={workflowName}`, { headers: { 'Accept': 'application/json' } }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.json());
200Response
1 2 3 4 5 6 7 8 9 10 11 12 [ { "id": "jira.i18n.title", "key": "jira.i18n.title", "value": "some.title" }, { "id": "jira.permission", "key": "jira.permission", "value": "createissue" } ]
PUT

Update workflow transition property

Updates a workflow transition by changing the property value. Trying to update a property that does not exist results in a new property being added to the 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.

Data Security Policy: Exempt from app access rules
Scopes
ClassicRECOMMENDED:manage:jira-configuration
Granular:write:workflow.property:jira, read:workflow.property:jira

Connect app scope requiredADMIN

Request

Path parameters

transitionId

integer

Required

Query parameters

key

string

Required
workflowName

string

Required
workflowMode

string

Request bodyapplication/json

value

string

Required
Additional Properties

any

Responses

200 response

application/json

WorkflowTransitionProperty

Details about the server Jira is running on.

PUT/rest/api/3/workflow/transitions/{transitionId}/properties
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; var bodyData = `{ "value": "createissue" }`; const response = await api.asUser().requestJira(route`/rest/api/3/workflow/transitions/{transitionId}/properties?key={key}&workflowName={workflowName}`, { method: 'PUT', headers: { 'Accept': 'application/json', 'Content-Type': 'application/json' }, body: bodyData }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.json());
200Response
1 2 3 4 5 { "key": "jira.i18n.title", "value": "some.title", "id": "jira.i18n.title" }
POST

Create workflow transition property

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.

Data Security Policy: Exempt from app access rules
Scopes
ClassicRECOMMENDED:manage:jira-configuration
Granular:write:workflow.property:jira, read:workflow.property:jira

Connect app scope requiredADMIN

Request

Path parameters

transitionId

integer

Required

Query parameters

key

string

Required
workflowName

string

Required
workflowMode

string

Request bodyapplication/json

value

string

Required
Additional Properties

any

Responses

200 response

application/json

WorkflowTransitionProperty

Details about the server Jira is running on.

POST/rest/api/3/workflow/transitions/{transitionId}/properties
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; var bodyData = `{ "value": "createissue" }`; const response = await api.asUser().requestJira(route`/rest/api/3/workflow/transitions/{transitionId}/properties?key={key}&workflowName={workflowName}`, { method: 'POST', headers: { 'Accept': 'application/json', 'Content-Type': 'application/json' }, body: bodyData }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.json());
200Response
1 2 3 4 5 { "key": "jira.i18n.title", "value": "some.title", "id": "jira.i18n.title" }
DEL

Delete workflow transition property

Deletes a property from 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.

Data Security Policy: Exempt from app access rules
Scopes
ClassicRECOMMENDED:manage:jira-configuration
Granular:delete:workflow.property:jira

Connect app scope requiredADMIN

Request

Path parameters

transitionId

integer

Required

Query parameters

key

string

Required
workflowName

string

Required
workflowMode

string

Responses

200 response

DEL/rest/api/3/workflow/transitions/{transitionId}/properties
1 2 3 4 5 6 7 8 9 10 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; const response = await api.asUser().requestJira(route`/rest/api/3/workflow/transitions/{transitionId}/properties?key={key}&workflowName={workflowName}`, { method: 'DELETE' }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.text());

Rate this page: