Saltar al contenido principal
PATCH
Actualizar varios objetos blob a la vez
Aplica los mismos changes a hasta 100 objetos en una sola llamada. La respuesta tiene un resultado por ID: ok: true con el objeto actualizado, o ok: false con el code de error de ese objeto. Un fallo en un objeto no detiene a los demás. Ámbito: blob:write.
string[]
requerido
IDs de objeto, de 1 a 100.
object
requerido
Los campos que se van a cambiar, con el mismo significado que en Actualizar un objeto blob: visibility, cache_control, content_disposition, filename, expires_at, metadata.
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[]
Un resultado por ID solicitado, en el mismo orden.

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.
Última modificación el 28 de octubre de 2026