# Ethora AI Widget API

**Canonical:** https://apis.io/apis/ethora-com/ethora-com-ai-widget-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 AI Widget 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 AI Widget. The published artifact set on APIs.io includes an OpenAPI specification.

AI Widget integration endpoints. <br />ℹ️ The widget is the embeddable chat experience served by `assistant.js`; visitors are anonymous (XMPP-only Mongo Users tagged `isVisitor:true`), conversations are persistent MUC rooms tagged `chats.type='widget'`, and the AI bot is the App's configured agent.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| POST | `/v2/widget/sessions` | Provision an AI Widget visitor session |
| GET | `/v2/widget/config` | Public AI Widget config for an app |
| GET | `/v2/apps/{appId}/widget/appearance` | Get the stored AI Widget appearance for an app |
| PUT | `/v2/apps/{appId}/widget/appearance` | Replace the stored AI Widget appearance for an app |
| GET | `/v2/apps/{appId}/widget/conversations` | List AI Widget conversations for an app |

## Machine-readable artifacts (1)

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

## Other Ethora APIs (8)

- [Ethora Agents API](https://apis.io/apis/ethora-com/ethora-com-agents-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

AI Widget

---

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