Ethora

Ethora Users API

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

GitHub OpenAPI

Operations 50

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 #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/ethora-com/openapi/ethora-com-users-api-openapi.yml

Schemas & Data

📊
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

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/ethora-com:ethora-com-users-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

ethora-com-users-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Platform Users API
  description: 'Ethora Platform API.


    ## Getting Started

    - For new backend and tenant integrations, start with the `/v2/...` endpoints.

    - Use `/v2/apps/{appId}/...` when your backend/admin flow manages a specific target app explicitly.

    - Some legacy operations still exist only under `/v1/...`; when so, the operation description will say so.


    ## Integration Tracks

    - `Frontend / app runtime`: app-auth login/sign-up flows, then user-auth chats/files/sharelinks.

    - `Tenant admin / B2B backend`: explicit app management and app-scoped admin flows under `/v2/apps/{appId}/...`.


    ## Auth Token Legend

    - `App JWT`: app-scoped runtime token for sign-up/login/runtime app operations.

    - `User JWT`: end-user or admin-user session token.

    - `Refresh JWT`: refresh-only token for access token renewal.

    - `Client JWT`: legacy client-side token used only for chat/client credential exchange compatibility flows.

    - `B2B Server JWT`: tenant/backend integration token. Prefer `Authorization: Bearer `; `x-custom-token` is still accepted for backward compatibility.


    ## Which Token Where

    - `App JWT`: `/v1/users/login-with-email`, `/v2/users/sign-up-with-email`, similar app-runtime auth endpoints.

    - `User JWT`: user session endpoints like chats, files, sharelinks, profile/session management.

    - `B2B Server JWT`: tenant/backend integration endpoints, especially explicit `/v2/apps/{appId}/...` admin flows.

    - `Client JWT`: only where the endpoint explicitly says `Client JWT` and typically only for legacy compatibility.


    ## Auth Approach

    - `/v2/...` endpoints are the canonical API surface for new integrations.

    - Endpoints may support one or more token types depending on the actor and scope.

    - App-scoped admin/integration endpoints use `/v2/apps/{appId}/...` so the target app is always explicit.

    - When an endpoint supports both `User JWT` and `B2B Server JWT`, Swagger will show both under Security.

    - Public Swagger excludes internal-only, operational, and experimental surfaces.'
  contact:
    name: Dappros developers team
  version: 26.11.05
servers:
- url: https://api.chat.ethora.com
security:
- JwtAuth: []
tags:


# --- truncated at 32 KB (104 KB total) ---
# Full source: https://artifacts.apis.io/ethora-com/openapi/ethora-com-users-api-openapi.yml