My work

update-deadline-status-tool

Move a deadline to a different kanban column.

Sets a deadline's status. The is_finished flag is auto-synced — moving to finished sets it to true, and moving away from finished clears it back to false.

See also: update-deadline-tool when you also need to change the description, due date, assignee or other fields. This tool is the narrow status-only fast path.

Inputs

NameTypeRequiredDescription
idintegeryesDeadline id.
statusstringyesOne of on-hold, new, active, internal-test, external-test, finished.

Permissions

  • Moving your own deadline: kanban::manage_self or kanban::manage_for_others.
  • Moving someone else's deadline: kanban::manage_for_others.

Example

{
  "id": 21,
  "status": "external-test"
}

Response

The updated deadline, in the same shape as a row from list-deadlines-tool.

Errors

  • An invalid status value returns a validation error.
  • Moving a deadline you don't own without kanban::manage_for_others returns an authorization error.
  • A non-existent id returns a 404-style error.

On this page