Add a custom domain

Attach a custom domain to a service with automatic TLS provisioning

POST

/auth/v1/seed/{namespace}/services/{name}/domains

curl --request POST \
  --url /auth/v1/seed/{namespace}/services/{name}/domains \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"domain":"api.example.com"}'

Path parameters

namespace

string

required

The namespace (user or organization) the service belongs to.

name

string

required

The service name to attach the domain to.

Body parameters

domain

string

required

The custom domain to add (e.g., `"api.example.com"`). Must be a valid hostname.

[Note] DNS configuration required. After adding a domain, create a CNAME record at your DNS provider pointing the domain to the cname_target value. You may also need to add a TXT record with the verification_token for ownership verification. Once DNS propagates, call the verify endpoint.

Previous → Delete a volume

Next List domains →