API reference

The Wocha Customer API is the programmatic management interface for SaaS tenants. Authenticate with a management API key (wocha_mgmt_...) or OAuth 2.0 bearer token.

Cloud base URL: https://TENANT.api.wocha.ai/v1 (replace TENANT with your tenant slug)

Sandbox base URL: https://sandbox.api.wocha.ai/v1

Self-hosted base URL: point at your deployment's Customer API prefix.

Interactive playground

Send authenticated requests from your browser. Credentials stay in localStorage on your device. Switch between production and the shared sandbox tenant.

Loading playground…

OpenAPI explorer

Browse endpoints, schemas, and authentication options below. Set a bearer token in Scalar's auth panel to send requests against your tenant.

Browse the full schema below, or use the interactive playground and Try it buttons for authenticated requests with response timing and rate-limit headers.

Try endpoints

Each endpoint group includes an inline Try it panel pre-filled from the OpenAPI spec.

Loading endpoint groups…

Quick examples

Try a single endpoint inline in any doc page:

<TryIt endpoint="GET /users" />
<TryIt endpoint="POST /users" />
<TryIt endpoint="GET /webhooks" />

Authentication

Method	Header	Notes
Management API key	`Authorization: Bearer wocha_mgmt_...`	Recommended for server-side integrations
OAuth 2.0	`Authorization: Bearer eyJ...`	Access token with required scopes; add `X-Tenant-Id` when needed

Create and rotate keys in the Wocha Console or via the API.