# Elaichi Workflows API

**Canonical:** https://apis.io/apis/elaichi-ai/elaichi-ai-workflows-api/  
**Provider:** Elaichi — https://apis.io/providers/elaichi-ai/  
**Base URL:** https://api.elaichi.ai  
**Documentation:** https://elaichi.ai/docs/api-reference/overview/introduction

Elaichi Workflows API is one of 37 APIs that [Elaichi](https://apis.io/providers/elaichi-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Workflows. The published artifact set on APIs.io includes an OpenAPI specification and 1 JSON Schema.

The Workflows API from Elaichi — 55 operation(s) for workflows.

## Operations (60 of 63)

| Method | Path | Summary |
|---|---|---|
| GET | `/automation` | List workflows |
| POST | `/automation` | Create a workflow |
| GET | `/automation/examples` | Suggested workflows for the caller |
| POST | `/automation/validate` | Validate a definition before creating a workflow |
| GET | `/automation/{id}` | Get a workflow |
| PATCH | `/automation/{id}` | Update a workflow's name, description or enabled switch |
| DELETE | `/automation/{id}` | Delete a workflow |
| PUT | `/automation/{id}/draft` | Save a workflow draft |
| POST | `/automation/{id}/draft/discard` | Throw the draft away and go back to the live version |
| GET | `/automation/{id}/draft/head` | The draft's current revision |
| POST | `/automation/{id}/validate` | Validate this workflow's draft (or a candidate definition) |
| POST | `/automation/{id}/publish` | Publish the workflow's current draft |
| GET | `/automation/{id}/version` | List a workflow’s published versions |
| GET | `/automation/{id}/version/{vid}` | Get one published version, including its full definition |
| POST | `/automation/{id}/version/{vid}/republish` | Re-publish an older version as the new latest version |
| POST | `/automation/{id}/enable` | Enable a workflow |
| POST | `/automation/{id}/disable` | Disable a workflow |
| POST | `/automation/{id}/transfer` | Transfer ownership of a workflow |
| POST | `/automation/{id}/share` | Share a workflow |
| GET | `/automation/{id}/share` | List a workflow’s shares |
| DELETE | `/automation/{id}/share/{aclId}` | Revoke a workflow share |
| POST | `/automation/{id}/run` | Run a workflow manually |
| GET | `/automation/{id}/run` | List a workflow’s runs |
| POST | `/automation/{id}/dry-run` | Dry-run a workflow |
| GET | `/automation/{id}/run/{runId}` | Get one run |
| GET | `/automation/{id}/run/{runId}/step` | List a run’s steps |
| GET | `/automation/{id}/run/{runId}/progress` | Where a run is, step by step |
| GET | `/automation/{id}/run/{runId}/step/{seq}` | Get one run step, with its full output |
| POST | `/automation/{id}/run/{runId}/retry` | Retry a failed run |
| POST | `/automation/{id}/run/{runId}/cancel` | Cancel an active run |
| GET | `/automation/{id}/state` | List a workflow’s persisted state entries |
| GET | `/automation/{id}/webhook` | List a workflow’s webhook endpoints |
| POST | `/automation/{id}/webhook/{triggerKey}/reveal` | Reveal a webhook secret once |
| POST | `/automation/{id}/webhook/{triggerKey}/rotate` | Rotate a webhook secret |
| PUT | `/automation/{id}/webhook/{triggerKey}/secret` | Set an hmac webhook secret |
| GET | `/automation/{id}/webhook/{triggerKey}/sample` | List captured webhook samples |
| GET | `/automation/{id}/webhook/{triggerKey}/sample/{sampleId}` | Get one captured webhook sample, with its payload |
| DELETE | `/automation/{id}/webhook/{triggerKey}/sample/{sampleId}` | Delete one captured webhook sample |
| GET | `/automation/{id}/approval` | List one workflow’s approvals |
| GET | `/automation-approval` | List approvals across workflows |
| POST | `/automation-approval/resolve-batch` | Approve or reject up to 50 pending approvals at once |
| GET | `/automation-approval/{id}/next` | The next approval waiting on you after this one |
| GET | `/automation-approval/{id}` | Get one approval |
| GET | `/automation-approval/{id}/approver` | List who can resolve an approval |
| POST | `/automation-approval/{id}/resolve` | Approve or reject a pending approval |
| GET | `/automation/{id}/session` | List the runbook sessions of a workflow |
| GET | `/automation/{id}/session/{sessionId}` | Get one runbook session |
| GET | `/automation/{id}/session/{sessionId}/run` | List the runs of a session |
| POST | `/automation/{id}/session/{sessionId}/run` | Start another run in a session |
| GET | `/automation/{id}/session/{sessionId}/participant` | List the people who started runs in a session |
| GET | `/automation/{id}/session/{sessionId}/artifact` | List the collection rows a session produced |
| GET | `/automation/{id}/session/{sessionId}/message` | Preview the agent transcript of a session |
| POST | `/automation/{id}/session/{sessionId}/close` | Close a session |
| GET | `/automation/{id}/usage` | A workflow’s usage against its limits |
| GET | `/automation-approval/{id}/vote` | List the votes on an approval |
| GET | `/automation/{id}/run/{runId}/step/{seq}/transcript` | Read an agent step transcript |
| GET | `/automation/models` | List the AI models an agent step can use |
| GET | `/automation-slack/workspace` | List Slack workspaces a trigger can use |
| GET | `/automation-slack/channel` | List Slack channels the app is in |
| GET | `/automation/{id}/config` | Get a workflow config |

…and 3 more operations. They are listed in full on the page.

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/elaichi-ai/openapi/elaichi-ai-workflows-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/elaichi-ai/json-schema/elaichi-ai-acl-entry-schema.json

## Other Elaichi APIs (12)

- [Elaichi Access requests API](https://apis.io/apis/elaichi-ai/elaichi-ai-access-requests-api/)
- [Elaichi Apps API](https://apis.io/apis/elaichi-ai/elaichi-ai-apps-api/)
- [Elaichi Audit log API](https://apis.io/apis/elaichi-ai/elaichi-ai-audit-log-api/)
- [Elaichi Auth API](https://apis.io/apis/elaichi-ai/elaichi-ai-auth-api/)
- [Elaichi Collections API](https://apis.io/apis/elaichi-ai/elaichi-ai-collections-api/)
- [Elaichi Connections API](https://apis.io/apis/elaichi-ai/elaichi-ai-connections-api/)
- [Elaichi Connectors API](https://apis.io/apis/elaichi-ai/elaichi-ai-connectors-api/)
- [Elaichi Current user API](https://apis.io/apis/elaichi-ai/elaichi-ai-current-user-api/)
- [Elaichi Custom connectors API](https://apis.io/apis/elaichi-ai/elaichi-ai-custom-connectors-api/)
- [Elaichi Dashboards API](https://apis.io/apis/elaichi-ai/elaichi-ai-dashboards-api/)
- [Elaichi Entitlements API](https://apis.io/apis/elaichi-ai/elaichi-ai-entitlements-api/)
- [Elaichi Files API](https://apis.io/apis/elaichi-ai/elaichi-ai-files-api/)

## Tags

Workflows

---

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