Custom Domain
API referenceTenancy

One-call signup provisioning (tenant + owner + app + API key)

POST
/tenants:provision

Atomically creates a tenant, its first owner member, a default application, and a long-lived API key. api_key and client_secret are returned ONCE. Guarded by the dedicated provision secret (the X-Provision-Secret header or a Bearer token) so the customer console's server can hold this narrow secret instead of the operator management key.

Authorization

provisionSecret
X-Provision-Secret<token>

Narrow secret for the one-call signup provisioning endpoint (also accepted as a Bearer token).

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/tenants:provision" \  -H "Content-Type: application/json" \  -d '{    "tenant_name": "string"  }'
{  "tenant_id": "string",  "application_id": "string",  "api_key": "string",  "client_secret": "string"}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}