# List automations (/docs/api-reference/list_automations)

`GET /v1/automations` · operation `list_automations`

Lists your automations in this Workspace: what each does, when it runs, whether it's on, and its next run.

**Sign-in:** a signed-in person's access token (`Authorization: Bearer …`), which AI apps get through MCP sign-in; or a Workspace API key in the `X-SMB-API-Key` header.

### Query parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `room_id` | string | no | Only this Room's. |
| `status` | one of `active`, `paused`, `needs_attention` | no |  |

### Headers

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `SMB-Workspace-Id` | string (uuid) | yes | Workspace where this operation runs. Required for user tokens and Workspace API keys. |

### Response

**200** Successful authorized response.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | array of object | yes |  |
| `data[].id` | string | yes |  |
| `data[].name` | string | yes |  |
| `data[].action` | object | yes |  |
| `data[].trigger` | object | yes |  |
| `data[].where` | array of object | no | The conditions every event must match; empty for none. |
| `data[].room_id` | string or null | yes |  |
| `data[].business_id` | string or null | yes |  |
| `data[].notify` | string | yes |  |
| `data[].status` | one of `active`, `paused`, `needs_attention` | yes |  |
| `data[].attention_reason` | one of `failing`, `access_lost`, `webhook_gone` or null | yes |  |
| `data[].next_run_at` | string or null | yes |  |
| `data[].last_run_at` | string or null | yes |  |
| `data[].latest_run_at` | string or null | no |  |
| `data[].last_run_status` | one of `queued`, `starting`, `running`, `waiting_approval`, `succeeded`, `nothing_new`, `failed`, `skipped` or null | no |  |
| `data[].runs_as` | object or object | yes | Who it runs as: a person, or a platform service account. |
| `data[].created_at` | string | yes |  |
| `data[].updated_at` | string | yes |  |
| `request_id` | string | yes |  |

### Errors

- `400` The request is invalid.
- `401` Authentication is required.
- `403` The caller is not authorized.
- `404` The resource was not found.
- `409` The resource revision or idempotency input conflicts.
- `413` The request body is too large.
- `415` The request must be JSON.
- `422` Required evidence is missing.
- `429` Rate limit reached; honor Retry-After.
- `500` The request could not be completed.
- `502` A dependency returned an invalid response.
- `503` The service is temporarily unavailable.

### Example

```bash
curl --request GET "https://api.smb.co/v1/automations" \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header "SMB-Workspace-Id: $WORKSPACE_ID"
```