Files
coder/docs/reference/cli/provisioner_jobs_list.md
T
J. Scott Miller 7bde763b66 feat: add workspace build transition to provisioner job list (#24131)
Closes #16332

Previously `coder provisioner jobs list` showed no indication of what a workspace
build job was doing (i.e., start, stop, or delete). This adds
`workspace_build_transition` to the provisioner job metadata, exposed in
both the REST API and CLI. Template and workspace name columns were also
added, both available via `-c`.

```
$ coder provisioner jobs list -c id,type,status,"workspace build transition"
ID                                    TYPE                     STATUS     WORKSPACE BUILD TRANSITION
95f35545-a59f-4900-813d-80b8c8fd7a33  template_version_import  succeeded
0a903bbe-cef5-4e72-9e62-f7e7b4dfbb7a  workspace_build          succeeded  start
```
2026-04-10 09:50:11 -05:00

3.6 KiB
Generated

provisioner jobs list

List provisioner jobs

Aliases:

  • ls

Usage

coder provisioner jobs list [flags]

Options

-s, --status

Type [pending|running|succeeded|canceling|canceled|failed|unknown]
Environment $CODER_PROVISIONER_JOB_LIST_STATUS

Filter by job status.

-l, --limit

Type int
Environment $CODER_PROVISIONER_JOB_LIST_LIMIT
Default 50

Limit the number of jobs returned.

-i, --initiator

Type string
Environment $CODER_PROVISIONER_JOB_LIST_INITIATOR

Filter by initiator (user ID or username).

-O, --org

Type string
Environment $CODER_ORGANIZATION

Select which organization (uuid or name) to use.

-c, --column

Type [id|created at|started at|completed at|canceled at|error|error code|status|worker id|worker name|file id|tags|queue position|queue size|organization id|initiator id|template version id|workspace build id|type|available workers|template version name|template id|template name|template display name|template icon|workspace id|workspace name|workspace build transition|logs overflowed|organization|queue]
Default created at,id,type,template display name,status,queue,tags

Columns to display in table output.

-o, --output

Type table|json
Default table

Output format.