# CustomDomain Tenancy API

**Canonical:** https://apis.io/apis/customdomain-ai/customdomain-ai-tenancy-api/  
**Provider:** CustomDomain — https://apis.io/providers/customdomain-ai/  
**Base URL:** https://api.customdomain.ai/v1  
**Documentation:** https://docs.customdomain.ai/docs/api-reference

CustomDomain Tenancy API is one of 25 APIs that [CustomDomain](https://apis.io/providers/customdomain-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 3 JSON Schema definitions. Tagged areas include Tenancy. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 3 JSON Schemas.

Operator provisioning: tenants and one-call signup.

## Operations (7)

| Method | Path | Summary |
|---|---|---|
| POST | `/tenants` | Create a tenant |
| GET | `/tenants/{id}` | Get a tenant |
| PATCH | `/tenants/{id}` | Rename your workspace |
| POST | `/tenants:provision` | One-call signup provisioning (tenant + owner + app + API key) |
| POST | `/tenants/{tenant_id}/default-key` | Ensure the workspace default key exists (secret returned only when created) |
| POST | `/tenants/{tenant_id}/default-key:rotate` | Rotate the workspace default key (new secret returned once) |
| GET | `/stats` | Aggregate counts across all tenants (operator) |

## Machine-readable artifacts (5)

- **OpenAPI** — https://artifacts.apis.io/customdomain-ai/openapi/customdomain-ai-tenancy-api-openapi.yml
- **Documentation** — https://docs.customdomain.ai/docs/api-reference
- **JSONSchema** — https://artifacts.apis.io/customdomain-ai/json-schema/customdomain-ai-default-api-key-schema.json
- **JSONSchema** — https://artifacts.apis.io/customdomain-ai/json-schema/customdomain-ai-tenant-schema.json
- **JSONSchema** — https://artifacts.apis.io/customdomain-ai/json-schema/customdomain-ai-environment-schema.json

## Other CustomDomain APIs (12)

- [CustomDomain MCP Server](https://apis.io/apis/customdomain-ai/mcp-server/)
- [CustomDomain Agents API](https://apis.io/apis/customdomain-ai/customdomain-ai-agents-api/)
- [CustomDomain Analytics API](https://apis.io/apis/customdomain-ai/customdomain-ai-analytics-api/)
- [CustomDomain Applications API](https://apis.io/apis/customdomain-ai/customdomain-ai-applications-api/)
- [CustomDomain Billing API](https://apis.io/apis/customdomain-ai/customdomain-ai-billing-api/)
- [CustomDomain Cloud browser API](https://apis.io/apis/customdomain-ai/customdomain-ai-cloud-browser-api/)
- [CustomDomain Connect API](https://apis.io/apis/customdomain-ai/customdomain-ai-connect-api/)
- [CustomDomain Connections API](https://apis.io/apis/customdomain-ai/customdomain-ai-connections-api/)
- [CustomDomain Domains API](https://apis.io/apis/customdomain-ai/customdomain-ai-domains-api/)
- [CustomDomain Enterprise API](https://apis.io/apis/customdomain-ai/customdomain-ai-enterprise-api/)
- [CustomDomain Managed DNS API](https://apis.io/apis/customdomain-ai/customdomain-ai-managed-dns-api/)
- [CustomDomain Members API](https://apis.io/apis/customdomain-ai/customdomain-ai-members-api/)

## Tags

Tenancy

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/customdomain-ai/customdomain-ai-tenancy-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/customdomain-ai/.