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

# Actualizar un dominio personalizado de Blob

> Activa o desactiva el contenido web de un dominio personalizado: si sirve HTML, SVG y XML en el navegador o si siempre los descarga.

Cambia `web_content` de un dominio personalizado y devuelve el dominio. Con `true`, el dominio sirve los archivos `.html`,
`.htm`, `.xhtml`, `.svg` y `.xml` en el navegador con su tipo real; las páginas ejecutan JavaScript en un entorno aislado
sin formularios, sin cookies y sin navegar en la pestaña superior. Con `false` (por defecto), esos tipos siempre se
descargan. El cambio surte efecto en aproximadamente un minuto. El enlace público por defecto siempre descarga estos
tipos, sin importar esta configuración. Consulta [Dominios personalizados](https://docs.vertracloud.app/es-es/blob/custom-domains.md#servir-páginas-web)
para ver los riesgos.

**Ámbito:** `blob:write`.

**domain\_id** `string` *required*

El ID del dominio.

**web\_content** `boolean`

Activa (`true`) o desactiva (`false`) el contenido web en este dominio.

**workspace\_id** `string`

El ID del workspace, cuando el blob pertenece a un workspace. La petición actúa sobre el blob del propietario del
workspace y necesita el permiso `blob:read` del workspace (`blob:manage` en las rutas que modifican datos). Omítelo
para actuar sobre tu propio blob.

### Ejemplo de petición

```bash theme={null}
curl -X PATCH "https://blob.vertracloud.app/v1/domains/9a8b7c6d-5e4f-4a3b-b2c1-d0e9f8a7b6c5" \
  -H "Authorization: Bearer $VERTRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"web_content":true}'
```

### Respuesta

**response** `object`

El dominio actualizado.

**propiedades**

**id** `string`

ID del dominio.

**hostname** `string`

Solo el subdominio, por ejemplo `cdn.example.com`.

**status** `string`

`pending`, `active`, `failed` o `suspended`. Solo `active` sirve archivos.

**ssl\_status** `string`

Estado del certificado TLS del nombre de host.

**cname\_target** `string`

Apunta un registro CNAME de `hostname` a este valor.

**prefix** `string | null`

Si está definido, el dominio sirve solo esta carpeta.

**web\_content** `boolean`

`true` cuando el dominio sirve `.html`, `.htm`, `.xhtml`, `.svg` y `.xml` en el navegador (en entorno aislado); `false` cuando esos tipos siempre se descargan.

**verification** `object | null`

El registro TXT que demuestra que eres dueño del nombre de host. Solo está presente mientras el dominio no esté
`active`; después queda ausente o `null`.

**propiedades**

**type** `string`

Siempre `txt`.

**name** `string`

Nombre del registro TXT que hay que crear.

**value** `string`

Valor del registro TXT.

**created\_at** `string`

Fecha de creación en ISO 8601.

```json Response theme={null}
{
  "response": {
    "id": "9a8b7c6d-5e4f-4a3b-b2c1-d0e9f8a7b6c5",
    "hostname": "cdn.example.com",
    "status": "active",
    "ssl_status": "active",
    "cname_target": "cname.vertracloud.dev",
    "prefix": "images/",
    "web_content": true,
    "verification": null,
    "created_at": "2026-10-14T12:00:00.000Z"
  }
}
```

### Respuestas de error

**code** `string`

El código de error que indica el motivo del fallo. Valores posibles:

* `AUTH_TOKEN_MISSING` (`401`): No se envió la cabecera `Authorization`.
* `API_KEY_INVALID` (`401`): La clave de API no existe, fue revocada o su secreto no coincide.
* `API_KEY_SCOPE_DENIED` (`403`): La clave no tiene el ámbito que necesita esta ruta (`blob:read` o `blob:write`); `details.required` lo indica.
* `WORKSPACE_PERMISSION_DENIED` (`403`): Solo con `workspace_id`: no eres miembro, o tu rol no tiene el permiso de blob.
* `WORKSPACE_NOT_FOUND` (`404`): Solo con `workspace_id`: no existe un workspace con ese ID, o no eres miembro.
* `VALIDATION_ERROR` (`400`): `web_content` falta o no es un booleano. `details.path` indica el campo.
* `BLOB_CUSTOM_DOMAIN_NOT_FOUND` (`404`): No existe ningún dominio con ese ID en esta cuenta.

```json Error Response (401) theme={null}
{
  "code": "AUTH_TOKEN_MISSING"
}
```

```json Error Response (403) theme={null}
{
  "code": "API_KEY_SCOPE_DENIED"
}
```

```json Error Response (404) theme={null}
{
  "code": "WORKSPACE_NOT_FOUND"
}
```


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