Eliminar varios archivos

Elimina varios archivos a la vez, hasta 100 archivos por solicitud a la API, usando opcionalmente distintos filtros, como la fecha de subida, el tipo de archivo, la extensión, el tamaño, el nombre o los IDs de los arch

API de WhatsApp y CRM

Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.

DELETE https://api.getincloud.ai/v1/files

Elimina varios archivos a la vez, hasta 100 archivos por solicitud a la API, usando opcionalmente distintos filtros,

como la fecha de subida, el tipo de archivo, la extensión, el tamaño, el nombre o los IDs de los archivos.

Importante: usa este endpoint con cuidado, una vez eliminado, un archivo no se puede recuperar.

Quizá te interese eliminar archivos individuales por ID usando [este endpoint](#tag/Files/operation/deleteFile).

Prueba este endpoint en el probador de API en vivo

>¿Necesitas ayuda? Explora todos los tutoriales, más de 100 ejemplos de casos de uso y juega con el probador de API en vivo con ejemplos de código listos para usar en más de 15 lenguajes de programación, incluidos JavaScript/Node.js, PHP, Python, C#, Java, Ruby, Swift, Kotlin, Powershell, cURL y más.

Autenticación

Envía tu API key en el encabezado Token en cada petición.

Cuerpo de la petición

Campo	Tipo	Obligatorio	Descripción
`limit`	integer	No	Límite máximo de archivos a eliminar por solicitud a la API. Por defecto es `100`. `minimum: 1` · `maximum: 500` · `default: 100`
`ids`	array<string>	No	Elimina los archivos que coincidan con la lista dada de IDs de archivo separados por comas (24 caracteres hexadecimales de longitud)
`before`	string	No	Elimina los archivos subidos antes de la fecha dada en formato ISO 8601. Ej: 2022-06-01T15:30:00.000Z `format: date-time`
`after`	string	No	Elimina los archivos subidos después de la fecha dada en formato ISO 8601. Ej: 2022-06-01T15:30:00.000Z `format: date-time`
`expires`	string	No	Elimina los archivos que expiran antes de la fecha dada en formato ISO 8601. Ej: 2022-06-01T15:30:00.000Z `format: date-time`
`filename`	string	No	Elimina los archivos que coincidan con el nombre de archivo dado, mediante coincidencia parcial de palabras o de texto completo. Nota: úsalo con cuidado al pasar una cadena corta y genérica `minLength: 3` · `maxLength: 100`
`ext`	array<string>	No
`mime`	array<string>	No
`kind`	array<string>	No	Elimina los archivos que coincidan con uno de los tipos de archivo dados
`owner`	array<string>	No
`format`	string	No	Elimina archivos por formato de archivo `enum: ['gif', 'ptt', 'native']` · `default: native`
`permission`	string	No	Elimina archivos según el modo de permiso (solo disponible para administradores de la cuenta) `enum: ['public', 'readonly', 'private']`
`tags`	array<string>	No	Elimina los archivos que coincidan con una de las etiquetas dadas
`size`	integer	No	Elimina los archivos más grandes que el tamaño dado en bytes (1MB = `1000000` bytes) `minimum: 1` · `maximum: 50000000`
`origin`	string	No	Elimina los archivos que se subieron desde un archivo local (`upload`) o desde una URL remota (`remote`) `enum: ['remote', 'upload']`
`sha2`	array<string>	No	Elimina los archivos que coincidan con la lista dada de hashes SHA-2 de archivo (64 caracteres hexadecimales de longitud)

Respuestas

Código	Descripción
`200`	Devuelve una lista de los archivos eliminados. La lista estará vacía si no se eliminó ningún archivo.
`400`	Datos de consulta o de cuerpo de la solicitud no válidos
`401`	No autorizado - Token de API no válido o ausente
`403`	Faltan los permisos requeridos
`404`	Recurso no encontrado
`409`	Conflicto
`429`	Demasiadas solicitudes - Inténtalo de nuevo más tarde
`500`	Error inesperado
`501`	No implementado
`503`	Servicio temporalmente no disponible - Inténtalo de nuevo más tarde

// This code example requires you to have installed curl package
// Installation instructions here: https://curl.haxx.se/download.html

// Delete up to 100 image files
curl --request DELETE \
  --url https://api.getincloud.ai/v1/files \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"limit":100,"kind":"image"}'


// Delete up 100 files uplodaed in the 30 days month
curl --request DELETE \
  --url https://api.getincloud.ai/v1/files \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"after":"2026-09-04T14:52:47.034Z","before":"2026-10-04T14:52:47.034Z"}'


// Delete up to 30 files with custom MIME file
curl --request DELETE \
  --url https://api.getincloud.ai/v1/files \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"limit":30,"mime":"video/mp4"}'


// Delete files with the specified IDs
curl --request DELETE \
  --url https://api.getincloud.ai/v1/files \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"ids":"5f734dea0d77567691ff7109,5f734de50d77567691ff7103,5f734def0d77567691ff7101"}'


// Delete files with the specified tags
curl --request DELETE \
  --url https://api.getincloud.ai/v1/files \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"tags":"foo,bar,baz"}'


// Delete files with a custom permission value (only applicable for the account administrator)
curl --request DELETE \
  --url https://api.getincloud.ai/v1/files \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"permission":"public"}'


// Delete files uploaded by one or multiple agents (only applicable for the account administrator)
curl --request DELETE \
  --url https://api.getincloud.ai/v1/files \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"owner":"11134def0d77567691ff7102,1f734def0d77567691ff7101"}'

AnteriorEliminar archivo SiguienteImagen de vista previa

¿Te sirvió esta página?