# Ethora Apps API

**Canonical:** https://apis.io/apis/ethora-com/ethora-com-apps-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 Apps 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. This API exposes 1 JSON Schema definition. Tagged areas include Application. The published artifact set on APIs.io includes an OpenAPI specification and 1 JSON Schema.

Application and tenant-admin management. <br />ℹ️ Use `/v2/apps` and `/v2/apps/{appId}/...` for explicit backend/admin integrations.

## Operations (41)

| Method | Path | Summary |
|---|---|---|
| GET | `/v2/apps` | List apps available to the current tenant actor (v2) |
| POST | `/v2/apps` | Create a child app for the current tenant actor (v2) |
| GET | `/v2/apps/{appId}` | Get a specific app visible to the current tenant actor (v2) |
| PATCH | `/v2/apps/{appId}` | Update a specific app visible to the current tenant actor (v2) |
| DELETE | `/v2/apps/{appId}` | Archive (soft-delete) or purge an app (v2) |
| POST | `/v2/apps/{appId}/restore` | Restore a previously archived app (v2) |
| GET | `/v2/apps/{appId}/export` | Export an App and its child entities as a portable bundle (v2) |
| POST | `/v2/apps/import` | Import a previously-exported App bundle (v2) |
| GET | `/v2/apps/purge-jobs/{jobId}` | Poll the status of a hard-delete cascade purge job (v2) |
| GET | `/v2/apps/{appId}/tokens` | List app tokens (metadata only) (v2, tenant actor) |
| POST | `/v2/apps/{appId}/tokens` | Create a new app token (returns token once) (v2, tenant actor) |
| DELETE | `/v2/apps/{appId}/tokens/{tokenId}` | Revoke an app token (idempotent) (v2, tenant actor) |
| POST | `/v2/apps/{appId}/tokens/{tokenId}/rotate` | Rotate an app token (revoke old, create new) (v2, tenant actor) |
| GET | `/v2/apps/{appId}/webhooks` | List the app's webhooks (v2, tenant actor) |
| POST | `/v2/apps/{appId}/webhooks` | Create a webhook (returns its secret once) (v2, tenant actor) |
| PATCH | `/v2/apps/{appId}/webhooks/{id}` | Update a webhook (v2, tenant actor) |
| DELETE | `/v2/apps/{appId}/webhooks/{id}` | Delete a webhook (v2, tenant actor) |
| POST | `/v2/apps/{appId}/webhooks/{id}/test` | Send a webhook.test event now (v2, tenant actor) |
| POST | `/v2/apps/{appId}/provision` | Provision default rooms for an app (v2, tenant actor) |
| POST | `/v1/apps` | Create app |
| GET | `/v1/apps` | List accessible apps |
| GET | `/v1/apps/users/` | List app users |
| GET | `/v1/apps/users/{xmppUsername}` | Get app user by XMPP username |
| PUT | `/v1/apps/{id}` | Update app |
| DELETE | `/v1/apps/{id}` | Delete app |
| GET | `/v1/apps/{id}` | Get app |
| POST | `/v1/apps/create-app-chat/{id}` | Create default app chat |
| DELETE | `/v1/apps/delete-app-chat/{id}` | Delete default app chat |
| PUT | `/v1/apps/user-defaults/{id}` | Update app user defaults |
| POST | `/v1/apps/check-domain-name` | Check app domain availability |
| GET | `/v1/apps/get-config` | Get app config by domain |
| GET | `/v1/apps/get-default-rooms` | Get current app default rooms |
| GET | `/v1/apps/get-default-rooms/app-id/{appId}` | Get app default rooms by appId |
| DELETE | `/v1/apps/rotate-jwt/{id}` | Rotate app JWT |
| GET | `/v1/apps/graph-statistic/{appId}` | Get app graph statistics |
| GET | `/v1/apps/stat-csv` | Export app statistics CSV |
| GET | `/v2/apps/{appId}/bot` | Get AI bot settings for an app (v2, tenant actor) |
| PUT | `/v2/apps/{appId}/bot` | Update AI bot settings for an app (v2, tenant actor) |
| GET | `/v2/apps/{appId}/chat-component/config` | Get the stored chat component config for an app |
| PUT | `/v2/apps/{appId}/chat-component/config` | Replace the stored chat component config for an app |
| GET | `/v2/apps/{appId}/ai-usage` | AI tokens an App spent (v2, tenant actor) |

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/ethora-com/openapi/ethora-com-apps-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/ethora-com/json-schema/ethora-com-app-token-rotate-response-schema.json

## Other Ethora APIs (8)

- [Ethora Agents API](https://apis.io/apis/ethora-com/ethora-com-agents-api/)
- [Ethora AI Widget API](https://apis.io/apis/ethora-com/ethora-com-ai-widget-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

Application

---

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