/v2/compute/domains and require a valid Telnyx API key in the Authorization header.
Create a custom domain
201 Created
_telnyx-verification.api.acme.com with the verification_token value, then call the verify endpoint.
Errors:
List custom domains
Response:
200 OK
Get a single domain
200 OK with a single domain object.
Verify domain ownership
_telnyx-verification.<domain> against the stored token.
On success: Deploys HTTP routing (Gateway + HTTPRoute + Ingress) to all clusters, marks domain as verified.
On failure: Marks as verification_failed.
On DNS error: Returns 503 Service Unavailable — retry later.
Response: 200 OK with updated domain object.
Upload TLS certificate
verified.
Validates:
- Cert/key pair is valid PEM
- Cert covers the domain (SAN or CN match)
- Cert is currently valid (not expired, not yet valid)
200 OK with updated domain object (cert_status: "active").
Errors:
Delete a domain
function_id is null), the domain is still deletable — routing cleanup is attempted but may be a no-op.
Response: 200 OK with the deleted domain object.
Status reference
Verification status
Cert status
Function deletion behavior
When a bound function is deleted, the domain’sfunction_id becomes null (ON DELETE SET NULL). The domain still exists but cannot route. To fix: delete the domain and create a new one with the correct function.