> ## Documentation Index
> Fetch the complete documentation index at: https://docs.collabase.ch/llms.txt
> Use this file to discover all available pages before exploring further.

# List automations

> Return all automations accessible to the authenticated user.

Returns all automations that the current user created or has access to through space membership. Optionally filter to a specific space.

## Query parameters

<ParamField query="spaceId" type="string">
  Filter automations to those linked to a specific space ID. Omit to return all automations across all spaces.
</ParamField>

## Response

<ResponseField name="[].id" type="string">Automation ID.</ResponseField>
<ResponseField name="[].name" type="string">Automation name.</ResponseField>
<ResponseField name="[].description" type="string">Optional description.</ResponseField>
<ResponseField name="[].isEnabled" type="boolean">Whether the automation is active.</ResponseField>
<ResponseField name="[].triggerType" type="string">`COLLABASE_EVENT` | `WEBHOOK` | `SCHEDULE` | `MANUAL`</ResponseField>
<ResponseField name="[].spaceId" type="string">ID of the owning space, if set.</ResponseField>
<ResponseField name="[].createdAt" type="string">ISO 8601 creation timestamp.</ResponseField>

<RequestExample>
  ```bash cURL theme={"dark"}
  curl "https://your-collabase.ch/api/v1/automation" \
    -H "Authorization: Bearer cba_live_..."
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"dark"}
  [
    {
      "id": "auto-abc123",
      "name": "Notify on Test Failure",
      "isEnabled": true,
      "triggerType": "COLLABASE_EVENT",
      "spaceId": "space-001",
      "createdAt": "2026-03-01T10:00:00.000Z"
    }
  ]
  ```
</ResponseExample>