Registrar

Register a domain (fail-closed; requires Idempotency-Key)

Off on the hosted service. This route registers a domain without taking a payment, so it needs both SELL_PURCHASE_ENABLED and its own switch SELL_DIRECT_PURCHASE_ENABLED; buy through checkout instead. A required Idempotency-Key header dedupes retries so a registration is never charged twice.

A delegated agent token needs domains:purchase; the grant's monthly spend cap is charged first, and a purchase that would pass it answers 409. A tenant API key is refused with 401. A workspace that billing refuses answers 402.

post/registrar/purchase

Request

  • Base URL: https://api.customdomain.ai/v1
  • URL: https://api.customdomain.ai/v1/registrar/purchase
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.customdomain.ai/oauth/agent/authorize, token URL https://api.customdomain.ai/oauth/agent/token, scopes: domains:purchase)

Headers

Idempotency-Keystring required

Request body

domainstring required

Response

Order (idempotent replay)

Changes

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