---
title: "List automations"
method: GET
path: "/api/v1/automations"
tags: ["Automations"]
---

# List automations

`GET /api/v1/automations`

Returns workflows and agents through one runnable automation collection. Use `type` to narrow to workflows or agents, and `search` to find automations by slug, name, or description.

## Query parameters

- `search` string — Substring match against slug, name, or description
- `type` 'workflow' | 'agent' — Filter by implementation type
- `limit` integer — Maximum number of automations to return.
- `offset` integer — Zero-based offset for paging through automations.

## Response `200`

Page of runnable workflow and agent automations.

- ListAutomationsResponse
  - `data` AutomationSummary[], required
    - `id` string, required — Implementation id for the automation. Workflow automations use workflow ids; agent automations use agent workflow ids.
    - `type` 'workflow' | 'agent', required
    - `slug` string, required
    - `name` string, nullable, required
    - `description` string, nullable
    - `status` string
    - `version` string, nullable
    - `triggers` AutomationTriggerState
      - `api` boolean, required
      - `email` boolean, required
      - `manual` boolean, required
      - `cron` boolean, required
    - `implementationAvailable` boolean — False when the automations registry row exists but the workflow/agent implementation row is missing.
    - `createdAt` union, required
      - string
      - string
    - `updatedAt` union
      - string
      - string
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required

## Other responses

- `400` — Validation error. Request shape did not match the spec.
- `401` — Missing or invalid API key
- `403` — API key lacks required scope
- `404` — Resource not found
- `413` — Payload too large. Upload exceeded the per-request size cap.
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.dev/eigenpal/apis/eigenpal-api.md) · [All operations](https://skmtc.dev/eigenpal/apis/eigenpal-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/eigenpal/eigenpal-api/revisions/dddcddf1975c/schema)