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

# Dominios CDN propios

> Cómo conectar tu propio dominio a la CDN del equipo.

Un dominio propio sirve los archivos del equipo en direcciones como `https://files.example.com/images/logo.png`. Todas las operaciones con dominios requieren permiso de gestión de la CDN del equipo.

**1. Vincula la clave al equipo**

Llama a `PUT /v3/cdn/team` con el `teamId` de tu equipo.

**2. Añade el dominio**

Llama a `POST /v3/cdn/custom-domains` con `{ "domain": "files.example.com", "s3Backup": true }`. La respuesta incluye los registros DNS a verificar.

**3. Configura el DNS**

Añade en tu registrador los registros de la respuesta: un CNAME del dominio a `cname.erlcrussia.com` y el registro de propiedad.

**4. Verifica el dominio**

Llama a `POST /v3/cdn/custom-domains/{id}/verify`. El dominio está listo cuando `isVerified` es `true` y `cfSslStatus` es `active`.

**5. Sube un archivo**

Indica `domain=files.example.com` al subir con `POST /v3/cdn/assets` y abre el archivo en tu dominio.

## Gestión

* `PATCH /v3/cdn/custom-domains/{id}` cambia el origen externo (`originUrl`) y la copia de seguridad (`s3Backup`). Un `originUrl` vacío desactiva el origen externo.
* No se puede eliminar un dominio con archivos: elimínalos antes.
* El `deployHookToken` sirve para [purgar la caché desde CI/CD](https://apidocs.erlcrussia.com/es/tutorials/cdn-cache-purge-cicd.md). Guárdalo en los secretos de CI.
* Si la verificación falla, comprueba que los registros DNS coinciden con la respuesta y ya se propagaron.


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