[Experimental]

Create a custom domain

⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️

Registers a custom hostname for the service. The hostname must CNAME to the regional switchboard target before DNS verification can succeed. Returns 429 if the service has reached its domain quota (default: 3).

post/v1/services/{serviceId}/domains

Request

  • Base URL: https://api.prisma.io
  • URL: https://api.prisma.io/v1/services/{serviceId}/domains
  • Auth: one of:
    • OAuth 2 (authorization code, authorization URL https://auth.prisma.io/authorize, token URL https://auth.prisma.io/token, scopes: workspace:admin, offline_access)
    • HTTP bearer

Path parameters

serviceIdstring required

Request body

hostnamestring required

Response

Custom domain already registered on this service.

Changes

No recorded changes to this operation across all 1 revision of this API.