> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gosentrix.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Domains

> Manage custom domains for your tenant

Configure custom domains for your tenant.

## List Domains

<RequestExample>
  ```bash theme={null}
  curl -X GET https://cp.gosentrix.io/api/v1/tenants/{tenant_id}/domains \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```
</RequestExample>

## Add Domain

<RequestExample>
  ```bash theme={null}
  curl -X POST https://cp.gosentrix.io/api/v1/tenants/{tenant_id}/domains \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "domain": "app.example.com"
    }'
  ```
</RequestExample>

## Delete Domain

<RequestExample>
  ```bash theme={null}
  curl -X DELETE https://cp.gosentrix.io/api/v1/tenants/{tenant_id}/domains/{domain_id}?confirm_decommission=true&confirm_delete=true \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```
</RequestExample>

## Domain Verification

Domains must be verified via DNS before activation. The API provides verification instructions.

## Notes

* Requires tenant admin role
* Domain deletion requires two-step confirmation (decommission, then delete)
* See [Custom Domains Guide](/guides/custom-domains) for details