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

# Configurar Domínio Customizado

> Aponta um domínio próprio para o subdomínio existente da aplicação

```bash cURL theme={null}
curl -X POST 'https://api.sondercloud.app/v1/apps/{id}/domain' \
  -H 'Authorization: Bearer seu_token' \
  -H 'Content-Type: application/json' \
  -d '{
    "domain": "api.zynxapplications.com.br"
  }'
```

```json Success theme={null}
{
  "status": "success",
  "code": "DOMAIN_SET",
  "response": {
    "customDomain": "api.zynxapplications.com.br",
    "subdomain": "zynx-api.sondercloud.app",
    "status": "pending_verification",
    "dnsRecords": [
      {
        "type": "CNAME",
        "name": "api.zynxapplications.com.br",
        "value": "zynx-api.sondercloud.app",
        "ttl": "3600"
      }
    ],
    "instructions": "Crie o registro CNAME acima no seu provedor de DNS e aguarde a propagação."
  }
}
```

### Corpo da Requisição

**domain** `string` *required*

Domínio a ser apontado para a aplicação. Aceito com ou sem `http(s)://` — a API normaliza (remove protocolo, barras finais, e converte para minúsculas).

### Campos da Resposta

**response.status** `string`

Sempre `pending_verification` na criação — o CNAME ainda precisa ser criado e propagado no provedor de DNS do domínio.

> [!WARNING]
>
> A aplicação precisa já ter um subdomínio configurado. Sem isso, a requisição falha com `400`.

> [!WARNING]
>
> Configurar um domínio customizado reinicia a aplicação automaticamente para aplicar a mudança.

> [!NOTE]
>
> Um domínio só pode estar vinculado a uma aplicação por vez. Tentar reutilizar um `domain` já configurado em outra aplicação retorna `400`.


## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.sondercloud.app/llms.txt).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.