Saltar al contenido principal
POST
Añadir un dominio personalizado para Blob Storage
Añade un subdominio, como cdn.example.com, que sirve los archivos de blob públicos de la cuenta. Crea un registro CNAME de ese nombre de host que apunte a cname_target y el registro TXT de verification, y después llama a Verificar un dominio personalizado. El número de dominios depende del plan: 0 por debajo de Enterprise-4, y después 1, 3 y 10. Devuelve 201. Ámbito: blob:write.
string
requerido
Solo el subdominio, sin esquema ni ruta.
string
Sirve solo esta carpeta en el dominio. Omítelo para servir toda la cuenta.
boolean
Por defecto false. Si es true, el dominio sirve los archivos .html, .htm, .xhtml, .svg y .xml en el navegador con su tipo real, en un entorno aislado (sandbox). Consulta Dominios personalizados.
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

Respuesta

object
El dominio, que sigue pending hasta que se encuentra el CNAME y se verifica el registro TXT de propiedad. Solo pasa a active después de ambos. Responde con 201.

Respuestas de error

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): Un parámetro o un campo del cuerpo no superó la validación. details.path indica el campo.
  • INVALID_CUSTOM_DOMAIN_FORMAT (400): El nombre de host no es un subdominio válido.
  • PLAN_RESTRICTED_FEATURE (403): El plan no incluye dominios personalizados (por debajo de Enterprise-4).
  • BLOB_NAMESPACE_SUSPENDED (403): El almacenamiento de blob de la cuenta está suspendido, o su plan expiró.
  • BLOB_CUSTOM_DOMAIN_LIMIT (409): El plan incluye dominios personalizados y se alcanzó el límite.
  • BLOB_CUSTOM_DOMAIN_TAKEN (409): El nombre de host ya está en uso.
Última modificación el 28 de octubre de 2026