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

# Automations API

> Manage automation templates, configs, skills, runs, approvals, outputs, and capabilities.

Use the Automations API for repeatable operational workflows that can inspect Squasher data, produce outputs, and request approval for risky actions.

## Configuration operations

| Operation                   | Method and path                                                | Purpose                                                |
| --------------------------- | -------------------------------------------------------------- | ------------------------------------------------------ |
| `automations.listTemplates` | `GET /v1/projects/{project_id}/automation-templates`           | List available templates.                              |
| `automations.list`          | `GET /v1/projects/{project_id}/automations`                    | List enabled, draft, and paused automations.           |
| `automations.create`        | `POST /v1/projects/{project_id}/automations`                   | Create an automation from a template or custom config. |
| `automations.preview`       | `POST /v1/projects/{project_id}/automations/preview`           | Dry-run a candidate config on recent data.             |
| `automations.get`           | `GET /v1/projects/{project_id}/automations/{automation_id}`    | Get config and recent run summary.                     |
| `automations.update`        | `PATCH /v1/projects/{project_id}/automations/{automation_id}`  | Update, pause, resume, or rename an automation.        |
| `automations.delete`        | `DELETE /v1/projects/{project_id}/automations/{automation_id}` | Delete an automation and its run history.              |

## Skills, runs, and outputs

| Operation family      | Paths                                                                                  | Purpose                                                                                       |
| --------------------- | -------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| Skills                | `/automation-skills`                                                                   | List, upsert, get, or delete project-scoped automation skills.                                |
| Runs                  | `/automations/{automation_id}/runs`, `/automation-runs/{run_id}`                       | Trigger, list, inspect, or cancel automation runs.                                            |
| Outputs and approvals | `/automation-runs/{run_id}/outputs`, `/approvals`, `/approve`, `/reject`, `/create-pr` | Review outputs, approve or reject risky output, or create a draft PR from an approved output. |
| Capabilities          | `/automation-capabilities`                                                             | List or define capability manifests.                                                          |

Use `preview` before creating or changing a custom config. Use approval endpoints only after the user has inspected the exact output id.

## CLI and MCP

Use `squasher automations ...` for terminal workflows. In MCP Code Mode, call `search("automations")`; ask before writes, run triggers, cancellations, approvals, rejections, and PR creation.

## Agent handoff

```text theme={null}
Evaluate Squasher automations for project <project_id>. List templates and current automations, preview any proposed config, and return the automation id, run id, output id, and approval state. Do not emit approvals, create PRs, cancel runs, or delete skills without explicit confirmation.
```

Related: [Automations](/features/automations), [Agent skills](/integrations/agent-skills).