capabilities.work

Transition an Issue to a New Status

A 4-step recipe with Jira. We can help you get access.

Recipe · 4 steps

Transition an Issue to a New Status

with Jira
Works with AI assistants

Move a Jira issue through its workflow using a runtime-discovered transition.

  1. Read the issue and capture its current status so the transition can be confirmed as an actual change rather than a no-op.
  2. List the transitions the caller can perform on this issue from its current status, expanding transition fields so required screen fields are visible.
  3. Perform the requested transition, optionally setting a resolution as part of the move. This operation returns 204 with no body on success.
  4. Re-read the issue to confirm the workflow status changed and to capture the resolution recorded by the transition.
What you'll need to have ready
  • issueIdOrKey: The id or key of the issue to transition (e.g. PROJ-123).
  • transitionId: The id of the transition to perform, selected from the transitions discovered by the listTransitions step.
  • resolutionName: The name of the resolution to set during the transition (e.g. Fixed). Only valid when the transition's screen exposes the resolution field.
For your developer

Arazzo workflow jira:transition-issue, 4 operations: getRestApi3IssueByIssueIdOrKey → getTransitions → doTransition → getRestApi3IssueByIssueIdOrKey. Specs on APIs.io.

More recipes with Jira

Read an Issue Comment Thread and ReplyCreate an Issue and Read It BackDeduplicate Issue IntakeEdit an Issue and Verify the ChangeBootstrap Issue Creation MetadataRun a JQL Report and Drill Into a ResultDiscover a Project and Its Workflow StatusesSafely Delete an IssueSweep a Stale Issue Through a Transition