DELETE

Endpoint /api/delete-knowledge

URL

https://api.integrationit.co/api/delete-knowledge

Descripción

Este endpoint permite eliminar uno o varios archivos de la base de conocimiento. Los archivos eliminados también serán removidos de la base de conocimiento del agente de IA si ya habían sido procesados.

Autenticación

Requiere el header x-api-key con una API key válida.

Parámetros

fileIds(array)Requerido

Array con los IDs de los archivos a eliminar. Puede contener uno o varios IDs.

Respuesta

La respuesta confirma la eliminación de los archivos:

{
  "success": true,
  "message": "Archivos eliminados correctamente",
  "deleted_files": [
    "id del archivo",
    "id del archivo"
  ]
}

Ejemplos

curl -X DELETE https://api.integrationit.co/api/delete-knowledge \
  -H "x-api-key: SU_API_KEY_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "fileIds": ["123e4567-e89b-12d3-a456-426614174000", "223e4567-e89b-12d3-a456-426614174001"]
  }'

// Usando fetch
const response = await fetch('https://api.integrationit.co/api/delete-knowledge', {
  method: 'DELETE',
  headers: {
    'x-api-key': 'SU_API_KEY_AQUI',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    fileIds: [
      "123e4567-e89b-12d3-a456-426614174000", 
      "223e4567-e89b-12d3-a456-426614174001"
    ]
  })
});

const data = await response.json();
console.log(data);

import requests

url = "https://api.integrationit.co/api/delete-knowledge"
headers = {
    "x-api-key": "SU_API_KEY_AQUI",
    "Content-Type": "application/json"
}
payload = {
    "fileIds": [
        "123e4567-e89b-12d3-a456-426614174000", 
        "223e4567-e89b-12d3-a456-426614174001"
    ]
}

response = requests.delete(url, headers=headers, json=payload)
print(response.json())

Notas adicionales

¡Advertencia!

Esta operación es irreversible. Una vez eliminados los archivos, no podrán ser recuperados.

Si alguno de los IDs proporcionados no existe o no pertenecen a su empresa, la operación fallará con un mensaje de error.
Para obtener los IDs de los archivos disponibles, utilice el endpoint /api/knowledge-files.
Esta operación elimina tanto el archivo del almacenamiento como su registro en la base de datos.