Saltar al contenido principal
POST
Crear un token de subida para subidas desde el navegador
Crea un token de subida que un navegador u otro cliente no confiable puede usar para subir archivos, sin tu clave de API. El token fija cada restricción que envías: un path para un archivo o un prefix para cualquier archivo de una carpeta, el tamaño máximo, las extensiones permitidas y la visibilidad. Solo funciona en las rutas de subida, y deja de funcionar cuando se revoca la clave de API que lo creó. El token se muestra una sola vez. Ámbito: blob:write.
string
Ruta exacta a la que puede subir el token. Usa este o prefix, no ambos.
string
Carpeta en la que puede subir el token. El sufijo aleatorio es obligatorio. Usa este o path, no ambos.
string
public o private. Lo fija el token.
number
Archivo más grande que acepta el token, en bytes.
string[]
De 1 a 20 extensiones, en minúsculas, sin el punto.
string
cache_control fijo para los objetos subidos.
string
inline o attachment fijo para los objetos subidos.
string
Marca de tiempo ISO 8601 para la eliminación de los objetos subidos.
object
metadata fija para los objetos subidos. Enterprise-12 o superior.
boolean
Permite que las subidas con este token reemplacen un archivo existente. Por defecto false: sin él, el token nunca sobrescribe un archivo que ya existe.
number
Segundos que el token sigue válido, de 60 a 3600. Por defecto 900.
number
Cuántas subidas permite el token, de 1 a 100. Por defecto 1.
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 token. Se muestra una vez.

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.
  • BLOB_NAMESPACE_SUSPENDED (403): El almacenamiento de blob de la cuenta está suspendido, o su plan expiró. Las subidas y otras escrituras se rechazan desde el inicio del periodo de gracia de 72 horas.
  • VALIDATION_ERROR (400): Un parámetro o un campo del cuerpo no superó la validación. details.path indica el campo.
  • PLAN_RESTRICTED_FEATURE (403): Se envió metadata en un plan inferior a Enterprise-12.
  • RATE_LIMIT_EXCEEDED (429): Más de 60 tokens creados en un minuto; details.retry_after indica cuántos segundos esperar.
Última modificación el 28 de octubre de 2026