Skip to content

jira issue transition

  • Usage: jira issue transition KEY... [STATUS] [flags]

Move one or more issues to a workflow status. Use it when advancing work through Jira from a script or terminal triage session.

Give the target status as a trailing argument, such as In Progress, or pass a numeric transition ID. A status name is resolved against each issue's available transitions at runtime; the same name can map to different IDs across workflows.

With no target, the command lists available transitions instead of mutating. --dry-run is a local preview and echoes the requested target without resolving it through Jira.

Input

--json-input <FILE>

Read transition payload from JSON file (canonical for agents)

Accepts a file.

--markdown <MARKDOWN>

Transition comment as Markdown, posted atomically with the status change

--markdown-file <FILE>

Read the Markdown body from a file; - reads stdin

Accepts a file.

Transition

--transition <STATUS>

Transition id or status name (or pass the status as a positional argument)

Safety

--dry-run

Preview mutation without submitting

Validation

--validate-remote

With --dry-run, resolve the target against the issue's live transitions (read-only fetch)

Execution

-p --parallelism <N>

Maximum concurrent requests (1-16)

Default: 1

Output fields

With --output json, the response envelope's data object carries these fields. Run jira agent schema for the full machine-readable schema.

Field Type Description
comment The validated ADF comment supplied with the transition.
dry_run boolean
fields object Validated field changes supplied with the transition.
issue.id string
issue.key string
issue.self string
transition string Resolved transition id; present when a target was applied (or validated under --dry-run --validate-remote).
transition_validated boolean Whether the transition target was resolved against Jira.
transitions Present on the no-target list form.
update object Native Jira update operations supplied with the transition.
warnings[].field string
warnings[].lossy boolean
warnings[].mark_type string
warnings[].message string
warnings[].node_type string
warnings[].path string
warnings[].type string

Examples

jira issue transition PROJ-123 # (1)!
jira issue transition PROJ-123 "In Progress" # (2)!
jira issue transition PROJ-123 PROJ-124 Done --dry-run # (3)!
  1. List available transitions for an issue
  2. Move an issue to a named status
  3. Preview transitioning several issues without contacting Jira