API reference
Tenants
Tenant (workspace) lifecycle and the per-tenant configuration endpoints.
Tenants are the unit of isolation. Authenticate server-side with an API key
(Authorization: ApiKey qk_…).
Lifecycle
POST
/v1/tenantsCreate a tenantGET
/v1/tenantsList tenantsGET
/v1/tenants/{id}Get a tenantPATCH
/v1/tenants/{id}Update a tenantDELETE
/v1/tenants/{id}Delete a tenantBash
curl -X POST https://api.qeetid.com/v1/tenants \
-H "Authorization: ApiKey $QEETID_API_KEY" \
-d '{ "name": "Acme, Inc." }'Switch active tenant
POST
/v1/auth/switch-tenantRe-mint a token scoped to another tenantPer-tenant configuration
These are documented in detail under Platform → Multi-tenancy:
| Area | Endpoint |
|---|---|
| Auth policy | GET/PUT /v1/tenants/{tenantID}/auth-policy |
| ABAC policy | GET/PUT /v1/tenants/{tenantID}/policy |
| Branding | GET/PUT /v1/tenants/{tenantID}/branding |
| Email templates | /v1/tenants/{tenantID}/email-templates |
| IP rules | /v1/tenants/{tenantID}/ip-rules |
| Retention | /v1/tenants/{tenantID}/retention |
| Analytics | GET /v1/tenants/{tenantID}/analytics/overview |
| Audit | GET /v1/tenants/{tenantID}/audit (+ /verify) |
| Secrets | /v1/tenants/{tenantID}/secrets |
| SSO (SAML/LDAP/SCIM/social) | see Enterprise |
Deleting a tenant cascades within its isolation boundary. Combine with GDPR erasure for personal-data deletion.