transition-work-item-status-tool

Move a work item to a different workflow status, validated against the project workflow.

Moves a work item to a different workflow status (kanban column). The transition is validated against the project workflow's configured transitions — illegal moves are rejected with an authorization error.

Use list-workflow-statuses-tool to discover the valid target statuses for a project and which transitions are allowed from each one.

Inputs

Name	Type	Required	Description
`work_item_key`	string	yes	Issue key of the work item to transition (e.g. `ACM-123`).
`workflow_status_id`	integer	yes	Target workflow status ID. Must be reachable from the work item's current status per the project workflow.

Permissions

project_management::manage_work_items (entry permission).
The user must also be allowed to manage the target work item by WorkItemPolicy.

Example

{
  "work_item_key": "ACM-123",
  "workflow_status_id": 12
}

Response

Returns the updated work item snapshot (same shape as get-work-item-by-key-tool).

Errors

An unknown work_item_key or workflow_status_id returns a validation error.
An illegal transition (no WorkflowTransition row from the current status to the target) returns an authorization error.
A caller without project_management::manage_work_items (or who fails the model policy) receives an authorization error.