Saltar al contenido principal
DELETE
Eliminar varios objetos blob o una carpeta
Elimina hasta 1.000 objetos en una sola llamada, por ids o por prefix de carpeta. Envía exactamente uno de los dos. La eliminación es permanente. Cuando hay más objetos que coinciden con un prefix, remaining es true; vuelve a hacer la llamada hasta que sea false. Ámbito: blob:write.
string[]
IDs de objeto, hasta 1.000. No lo envíes junto con prefix.
string
Elimina cada objeto cuya ruta empiece por este prefijo de carpeta, hasta 1.000 por llamada. No lo envíes junto con ids.
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
Lo que se eliminó en esta llamada.

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