Skip to main content
Workflow statuses are the task states the app knows about (for example open, in progress, closed). hirotm statuses list returns the full set in display order—the same statusId strings tasks add and tasks update accept for --status. This route is not tied to a single board: every board uses the same global status table. Global options and output modes: hirotm CLI. For shared connection options (--profile, --client-name), see hirotm CLI. Task commands that set status are documented in Tasks.

​
statuses list

OptionTypeRequiredDescription
--client-name <name>stringOptional; included for consistency with other commands (this call is read-only).
--fields <keys>stringComma-separated API keys per row. Allowed: statusId, label, sortOrder, isClosed. See Field projection.
Accepts global -q / --quiet (with --format ndjson); default field statusId. See Pipe-friendly quiet. CLI Examples 
hirotm statuses list
hirotm statuses list --fields statusId,label,isClosed
hirotm statuses list --profile dev                          # non-default profile
AI Agent Examples

List all workflow status ids and labels from Task Manager.

CursorOpen in Cursor
FieldMeaning
statusIdString you pass as --status on task commands.
labelHuman-readable name (shown in the app).
sortOrderDisplay order in the workflow.
isClosedWhether this status counts as “done” for UI behavior.

​
Learn more

Run hirotm help statuses for subcommand help. For how CLI access works on board routes, see CLI access policy.