Statuses

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`

Option	Type	Required	Description
`--client-name <name>`	string		Optional; included for consistency with other commands (this call is read-only).
`--fields <keys>`	string		Comma-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.

Open in Cursor

Show Example responses

{"statusId":"open","label":"Open","sortOrder":0,"isClosed":false}
{"statusId":"in-progress","label":"In progress","sortOrder":1,"isClosed":false}
{"statusId":"closed","label":"Closed","sortOrder":2,"isClosed":true}

StatusId       Label            Ord Closed
-------------- ---------------- --- ------
open           Open             0   false
in-progress    In progress      1   false
closed         Closed           2   true
count 3

{
  "error": "Server not reachable"
}

Field	Meaning
`statusId`	String you pass as `--status` on task commands.
`label`	Human-readable name (shown in the app).
`sortOrder`	Display order in the workflow.
`isClosed`	Whether 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.

Get Started

CLI

Hiro Developers

`statuses list`

Learn more

​statuses list

​Learn more

`statuses list`

Learn more