coder/docs/reference/cli/list.md

<!-- DO NOT EDIT | GENERATED CONTENT -->
# list

List workspaces

Aliases:

* ls

## Usage

```console
coder list [flags]
```

## Options

### -a, --all

|      |                   |
|------|-------------------|
| Type | <code>bool</code> |

Specifies whether all workspaces will be listed or not.

### --search

|         |                       |
|---------|-----------------------|
| Type    | <code>string</code>   |
| Default | <code>owner:me</code> |

Search for a workspace with a query.

### -c, --column

|         |                                                                                                                                                                                                       |
|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Type    | <code>[favorite\|workspace\|organization id\|organization name\|template\|status\|healthy\|last built\|current version\|outdated\|starts at\|starts next\|stops after\|stops next\|daily cost]</code> |
| Default | <code>workspace,template,status,healthy,last built,current version,outdated,starts at,stops after</code>                                                                                              |

Columns to display in table output.

### -o, --output

|         |                          |
|---------|--------------------------|
| Type    | <code>table\|json</code> |
| Default | <code>table</code>       |

Output format.