# Ethora Users API

**Canonical:** https://apis.io/apis/ethora-com/ethora-com-users-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 Users 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 2 JSON Schema definitions. Tagged areas include User. The published artifact set on APIs.io includes an OpenAPI specification and 2 JSON Schemas.

Managing Users. <br />ℹ️ Users are end user identities that have authenticated with one of the allowed sign on methods. <br />Each user receives an EVM (Ethereum) compatible "L2" cryptographic identity or wallet by default and additional wallets/IDs can be linked if required.

## Operations (50)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/users/` | end user' google, facebook, apple, crypto' signature |
| PUT | `/v1/users/` | Update current user |
| POST | `/v2/users/login/mfa` | Second login step for accounts with MFA enabled |
| POST | `/v2/users/me/password` | Change (or set) the logged-in user's password |
| GET | `/v2/users/me/mfa` | MFA status of the logged-in user |
| POST | `/v2/users/me/mfa/totp` | Start TOTP enrolment |
| DELETE | `/v2/users/me/mfa/totp` | Disable MFA |
| POST | `/v2/users/me/mfa/totp/confirm` | Confirm TOTP enrolment with a first code |
| POST | `/v2/users/me/mfa/backup-codes` | Regenerate backup codes |
| DELETE | `/v2/apps/{appId}/users/{userId}/access` | Remove a user's admin-panel access to an app |
| GET | `/v2/apps/{appId}/collaborators` | List the people who manage an app (v2) |
| POST | `/v2/apps/{appId}/collaborators` | Invite a colleague to manage an app (v2) |
| DELETE | `/v2/apps/{appId}/collaborators/{userId}` | Remove a colleague's access to an app (v2) |
| DELETE | `/v2/apps/{appId}/users/{userId}/mfa` | Reset a user's MFA (owner / admin recovery) |
| POST | `/v1/users/create-with-app-id/{id}` | If the user has the appropriate ACL, they can create other users for the… |
| POST | `/v1/users/create-many-with-app-id/{id}` | If the user has the appropriate ACL, they can create other users for the… |
| POST | `/v1/users/batch` | create user with x-custom-token |
| DELETE | `/v1/users/batch` | Delete users batch |
| POST | `/v2/users/batch` | Async batch user creation (enterprise-friendly) |
| GET | `/v2/users/batch/{jobId}` | Get async batch job status/results |
| POST | `/v2/apps/{appId}/users/batch` | Async batch user creation for a target app (v2, tenant actor) |
| DELETE | `/v2/apps/{appId}/users/batch` | Archive (soft-delete) or purge users in a target app (v2, tenant actor) |
| POST | `/v2/apps/{appId}/users/{userId}/restore` | Restore a soft-archived user (v2, tenant actor) |
| GET | `/v2/apps/{appId}/users/batch/{jobId}` | Get app-scoped batch user job status/results (v2, tenant actor) |
| GET | `/v1/users/tags/{appId}` | Tags in use on an app's users, with counts |
| POST | `/v1/users/tags-set/{appId}` | Set tags to the users. |
| POST | `/v1/users/tags-add/{appId}` | Add tags to the users |
| POST | `/v1/users/tags-delete/{appId}` | Removing tags specified in the request body from users |
| POST | `/v1/users/terms-and-conditions` | Accept the platform terms and conditions |
| POST | `/v1/users/xmpp-token` | Get a fresh XMPP connection token |
| GET | `/v1/users/me` | get user data with user access token |
| POST | `/v1/users/client` | Exchange legacy client JWT for user credentials |
| GET | `/v1/users/checkEmail/{email}` | Check email availability |
| GET | `/v1/users/{appId}` | List users in app |
| PUT | `/v1/users/{appId}/{userId}` | Update user in app |
| GET | `/v1/users/profile/{walletAddress}` | Get public profile by wallet |
| GET | `/v1/users/profile/{walletAddress}/{accessToken}` | Get public profile by wallet and access token |
| POST | `/v1/users/referral` | Create referral |
| DELETE | `/v1/users` | Delete current user |
| POST | `/v1/users/delete-many-with-app-id/{id}` | Delete many users in app |
| POST | `/v1/users/reset-passwords-with-app-id/{id}` | Reset many user passwords in app |
| POST | `/v1/users/emails` | Create email contact |
| GET | `/v1/users/emails` | List email contacts |
| DELETE | `/v1/users/emails/{email}` | Delete email contact |
| POST | `/v1/users/payments` | Create payment record |
| POST | `/v1/users/checkExtWallet` | Check external wallet |
| GET | `/v1/users/acl` | Get user ACL |
| PUT | `/v1/users/acl/{appId}/{userId}` | Update user ACL |
| GET | `/v1/users/exportData` | Export current user data |
| GET | `/v1/users/export/{appId}` | Export app users |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/ethora-com/openapi/ethora-com-users-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/ethora-com/json-schema/ethora-com-me-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/ethora-com/json-schema/ethora-com-user-data-b2-b-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 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/)

## Tags

User

---

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