# Ethora Agents API

**Canonical:** https://apis.io/apis/ethora-com/ethora-com-agents-api/  
**Provider:** Ethora — https://apis.io/providers/ethora-com/  
**Base URL:** https://api.chat.ethora.com  
**Documentation:** https://api.chat.ethora.com/api-docs/

Ethora Agents API is one of 9 APIs that [Ethora](https://apis.io/providers/ethora-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Agents. The published artifact set on APIs.io includes an OpenAPI specification.

AI Agents and their BotInstances. <br />ℹ️ An Agent is an account-level AI persona (prompt, model, Memory, knowledge, flows), embodied in an App as a BotInstance the first time it is invited into one of that App's chats. Platform-owned agents such as the Support Agent template are read-only to tenants, who clone them.

## Operations (39)

| Method | Path | Summary |
|---|---|---|
| POST | `/v2/agents/{id}/reply` | One-shot synchronous ask - text in, the agent's reply out (b2b) |
| GET | `/v2/agents/{idOrAddress}/export` | Export an Agent's configuration as a portable bundle (v2) |
| POST | `/v2/agents/import` | Import an Agent bundle (v2) |
| GET | `/v2/agents` | List AI Agents (v2) |
| POST | `/v2/agents` | Create an AI Agent (v2) |
| POST | `/v2/agents/flows/validate` | Check a flows script without saving it (v2) |
| POST | `/v2/agents/flows/generate` | Write a flows script with AI (v2) |
| GET | `/v2/agents/{idOrAddress}/flow-submissions` | Completed flow runs of an agent (v2) |
| GET | `/v2/agents/{idOrAddress}/flow-submissions.csv` | Flow submissions as CSV (v2) |
| POST | `/v2/agents/{idOrAddress}/flow-submissions/push` | Send stored submissions to a destination now (v2) |
| GET | `/v2/agents/{idOrAddress}/flow-webhook` | Flow webhook settings (v2) |
| PUT | `/v2/agents/{idOrAddress}/flow-webhook` | Set the flow webhook (v2) |
| POST | `/v2/agents/{idOrAddress}/flow-webhook/test` | Send a sample event to the webhook (v2) |
| POST | `/v2/agents/flows/simulate` | Try a flows script without an LLM (v2) |
| GET | `/v2/agents/{idOrAddress}` | Get an AI Agent (v2) |
| PUT | `/v2/agents/{idOrAddress}` | Update an AI Agent (v2) |
| DELETE | `/v2/agents/{idOrAddress}` | Delete an AI Agent (v2) |
| POST | `/v2/agents/{idOrAddress}/clone` | Clone an AI Agent (v2) |
| POST | `/v2/agents/{idOrAddress}/visibility` | Set an AI Agent's visibility (v2) |
| POST | `/v2/agents/{idOrAddress}/soul` | Replace or append to an AI Agent's Memory (v2) |
| GET | `/v2/agents/{idOrAddress}/knowledge` | Knowledge health of an AI Agent (v2) |
| POST | `/v2/agents/{idOrAddress}/knowledge/rebuild` | Rebuild an AI Agent's knowledge index (v2) |
| POST | `/v2/agents/{idOrAddress}/try` | Test conversation with an AI Agent, without a chat room (v2) |
| POST | `/v2/agents/{idOrAddress}/my-chat` | Open the caller's own 1-1 chat with an agent (v2) |
| GET | `/v2/agents/{idOrAddress}/bot-instances` | List the BotInstances of an AI Agent (v2) |
| GET | `/v2/agents/{idOrAddress}/bot-instances/{botInstanceId}/diag` | Diagnostics for one BotInstance of an AI Agent (v2) |
| POST | `/v2/agents/{idOrAddress}/bot-instances/{botInstanceId}/test-message` | Make a BotInstance post a test message (v2) |
| POST | `/v2/agents/{idOrAddress}/bot-instances/{botInstanceId}/leave-chat` | Remove a BotInstance from one chat (v2) |
| POST | `/v2/agents/{idOrAddress}/invite-to-chat` | Add an AI Agent to a chat (v2) |
| POST | `/v2/agents/{idOrAddress}/activate` | Make an AI Agent the App's website widget responder (v2, app-token) |
| GET | `/v2/apps/{appId}/agents` | List AI Agents (v2, tenant actor) |
| POST | `/v2/apps/{appId}/agents` | Create an AI Agent for an app (v2, tenant actor) |
| DELETE | `/v2/apps/{appId}/agents/{idOrAddress}` | Delete an AI Agent that belongs to an app (v2, tenant actor) |
| POST | `/v2/apps/{appId}/agents/{idOrAddress}/invite-to-chat` | Add an AI Agent to a chat (v2, tenant actor) |
| GET | `/v2/bot-instances` | List BotInstances (v2) |
| GET | `/v2/bot-instances/{id}` | Get a BotInstance (v2) |
| POST | `/v2/bot-instances/{id}/status` | Switch a BotInstance on or off, or set how it answers in one room (v2) |
| GET | `/v2/apps/{appId}/bot-instances` | List BotInstances (v2, tenant actor) |
| GET | `/v2/agents/{idOrAddress}/ai-usage` | AI tokens an agent used this month (owner only) |

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/ethora-com/openapi/ethora-com-agents-api-openapi.yml
- **APIsJSON** — https://artifacts.apis.io/ethora-com/apis.yml

## Other Ethora APIs (8)

- [Ethora AI Widget API](https://apis.io/apis/ethora-com/ethora-com-ai-widget-api/)
- [Ethora Apps API](https://apis.io/apis/ethora-com/ethora-com-apps-api/)
- [Ethora Auth API](https://apis.io/apis/ethora-com/ethora-com-auth-api/)
- [Ethora Chats API](https://apis.io/apis/ethora-com/ethora-com-chats-api/)
- [Ethora Files API](https://apis.io/apis/ethora-com/ethora-com-files-api/)
- [Ethora Push API](https://apis.io/apis/ethora-com/ethora-com-push-api/)
- [Ethora Sharelinks API](https://apis.io/apis/ethora-com/ethora-com-sharelinks-api/)
- [Ethora Users API](https://apis.io/apis/ethora-com/ethora-com-users-api/)

## Tags

Agents

---

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