# Tale Automations API

**Canonical:** https://apis.io/apis/tale-dev/tale-dev-automations-api/  
**Provider:** Tale — https://apis.io/providers/tale-dev/  
**Base URL:** https://your-host.example.com/api/v1  
**Documentation:** https://docs.tale.dev/develop/api-reference

Tale Automations API is one of 18 APIs that [Tale](https://apis.io/providers/tale-dev/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Automations. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.

Versioned automations, their runs and triggers — list, read, install, bind, run, cancel and delete. Authoring (save, validate, test, deploy) is not on this surface: it lives on `POST /api/v1/mcp` (`save_automation`, `validate_automation`, `test_automation`, `deploy_automation`, `set_trigger` — the MCP endpoint page of the developer docs), in the app’s automation editor, and in `tale deploy` for configuration packs. A deleted automation comes back by saving and deploying it again there.

## Operations (16)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/automations` | List automations |
| GET | `/api/v1/automations/{name}` | Get one automation version |
| DELETE | `/api/v1/automations/{name}` | Delete an automation |
| GET | `/api/v1/automations/{name}/versions` | List an automation’s versions |
| GET | `/api/v1/projects/{id}/automations` | List automations installed in a project |
| DELETE | `/api/v1/projects/{id}/automations/{name}` | Uninstall an automation from a project |
| POST | `/api/v1/projects/{id}/automations/{name}` | Install an automation in a project |
| GET | `/api/v1/automations/{name}/runs` | List an automation’s organization runs |
| POST | `/api/v1/automations/{name}/runs` | Start an organization automation run |
| GET | `/api/v1/projects/{id}/automations/{name}/runs` | List an automation’s runs in a project |
| POST | `/api/v1/projects/{id}/automations/{name}/runs` | Start an automation run in a project |
| GET | `/api/v1/automations/{name}/triggers` | Read the automation’s trigger |
| PUT | `/api/v1/automations/{name}/triggers` | Bind what starts the automation |
| DELETE | `/api/v1/automations/{name}/triggers` | Unbind the automation’s trigger |
| POST | `/api/automations/webhook/{token}` | Fire an organization webhook trigger |
| POST | `/api/projects/{id}/automations/webhook/{token}` | Fire a project webhook trigger |

## Machine-readable artifacts (8)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/tale-dev/refs/heads/main/openapi/tale-dev-automations-api-openapi.yml
- **Documentation** — https://docs.tale.dev/develop/api-reference
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/tale-dev/refs/heads/main/json-schema/tale-dev-run-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/tale-dev/refs/heads/main/json-schema/tale-dev-run-projection-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/tale-dev/refs/heads/main/json-schema/tale-dev-me-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/tale-dev/refs/heads/main/json-schema/tale-dev-run-summary-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/tale-dev/refs/heads/main/json-schema/tale-dev-document-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/tale-dev/refs/heads/main/json-schema/tale-dev-message-schema.json

## Other Tale APIs (12)

- [Tale Agents API](https://apis.io/apis/tale-dev/tale-dev-agents-api/)
- [Tale Browser sessions API](https://apis.io/apis/tale-dev/tale-dev-browser-sessions-api/)
- [Tale Contacts API](https://apis.io/apis/tale-dev/tale-dev-contacts-api/)
- [Tale Conversations API](https://apis.io/apis/tale-dev/tale-dev-conversations-api/)
- [Tale Documents API](https://apis.io/apis/tale-dev/tale-dev-documents-api/)
- [Tale Knowledge API](https://apis.io/apis/tale-dev/tale-dev-knowledge-api/)
- [Tale MCP API](https://apis.io/apis/tale-dev/tale-dev-mcp-api/)
- [Tale Model endpoints API](https://apis.io/apis/tale-dev/tale-dev-model-endpoints-api/)
- [Tale Notifications API](https://apis.io/apis/tale-dev/tale-dev-notifications-api/)
- [Tale Organization API](https://apis.io/apis/tale-dev/tale-dev-organization-api/)
- [Tale Products API](https://apis.io/apis/tale-dev/tale-dev-products-api/)
- [Tale Projects API](https://apis.io/apis/tale-dev/tale-dev-projects-api/)

## Tags

Automations

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/tale-dev/tale-dev-automations-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/tale-dev/.