Sign in
latestOpenAPI 3.1.0Proprietary2026-08-1095216168.4 KB

db81a447bba9

Tenants

Create tenant

Creates a new tenant with the caller as owner. Optionally provisions a default division in the same request. The new ids are returned in ld-tenant and ld-division response headers. Subject to per-user owned_tenants limit. Session-only: API keys are tenant-scoped and cannot create new tenants.

post/tenants

Request body

descriptionstring
emailstring
namestring required
protectedboolean nullable

Optional. When true, deletion is hardened: deleting this tenant will require a one-time confirmation code emailed to the tenant address (request via PUT /tenants/{tenant_id}/request_code with action = "delete_tenant"). Defaults to false when omitted.

Example request

{
  "description": "Production deployment for high-throughput streaming.",
  "division": {
    "description": "Production deployment for high-throughput streaming.",
    "email": "alice@laserdata.com",
    "name": "production"
  },
  "email": "alice@laserdata.com",
  "name": "acme-corp",
  "protected": true
}

Response

Tenant created. The new tenant ID is returned in the ld-tenant header