Saltar al contenido principal
POST
Crear un enlace para compartir un objeto Blob
Crea un enlace para compartir un único objeto privado: una página del sitio web donde el destinatario descarga el archivo. Los enlaces caducan tras expires_in segundos (por defecto, 24 horas), pueden dejar de funcionar después de max_downloads descargas y pueden exigir contraseña en Enterprise-12 o superior. Un enlace para compartir no protege un objeto público, así que en ese caso object_is_public es true. Ámbito: blob:write.
string
requerido
El objeto que se va a compartir.
number
Segundos hasta que el enlace deja de funcionar, de 60 a 2.592.000 (30 días). Por defecto, 86400 (24 horas).
number
Límite de descargas, de 1 a 10.000. Omítelo para no tener límite.
string
Contraseña que debe escribir el destinatario, de 8 a 128 caracteres. Enterprise-12 o superior.
string
El ID del workspace, cuando el blob pertenece a un workspace. La llamada actúa sobre el blob del propietario del workspace y necesita el permiso de workspace blob:read (blob:manage en las rutas que modifican datos). Omítelo para actuar sobre tu propio blob.

Ejemplo de petición

Respuesta

object
El enlace para compartir. 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 ningún workspace con ese ID o no eres miembro.
  • BLOB_NAMESPACE_SUSPENDED (403): El almacenamiento blob de la cuenta está suspendido o su plan ha caducado. Las subidas y demás escrituras se rechazan desde el inicio del periodo de gracia de 72 horas.
  • VALIDATION_ERROR (400): Un parámetro o campo del cuerpo no superó la validación. details.path indica el campo.
  • BLOB_OBJECT_NOT_FOUND (404): El object_id no existe en esta cuenta.
  • PLAN_RESTRICTED_FEATURE (403): Se envió password en un plan inferior a Enterprise-12.
Última modificación el 28 de octubre de 2026