POST

Endpoint /api/upload-knowledge

URL

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

Descripción

Este endpoint permite subir archivos a la base de conocimiento del agente de IA. Los archivos subidos pueden ser procesados posteriormente para entrenar al agente con información específica de su empresa o caso de uso.

Autenticación

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

Parámetros

file(file)Requerido

Archivo a subir. Formatos soportados: PDF

Respuesta

La respuesta incluye información sobre el archivo subido:

{
  "success": true,
  "message": "Archivo subido correctamente",
  "file": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "filename": "documento.pdf",
    "url": "url del archivo en storage",
    "size": 1024000,
    "company_name": "nombre de la empresa",
    "uploaded_at": "fecha de subida"
  }
}

Ejemplos

curl -X POST https://api.integrationit.co/api/upload-knowledge \
  -H "x-api-key: SU_API_KEY_AQUI" \
  -F "file=@/ruta/al/documento.pdf"

// Usando FormData con fetch
const formData = new FormData();
const fileInput = document.querySelector('input[type="file"]');
formData.append('file', fileInput.files[0]);

const response = await fetch('https://api.integrationit.co/api/upload-knowledge', {
  method: 'POST',
  headers: {
    'x-api-key': 'SU_API_KEY_AQUI'
    // No incluir Content-Type, se establecerá automáticamente con FormData
  },
  body: formData
});

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

import requests

url = "https://api.integrationit.co/api/upload-knowledge"
headers = {
    "x-api-key": "SU_API_KEY_AQUI"
}

files = {
    'file': ('documento.pdf', open('/ruta/al/documento.pdf', 'rb'), 'application/pdf')
}

response = requests.post(url, headers=headers, files=files)
print(response.json())

Notas adicionales

El tamaño máximo de archivo permitido es de 10MB.
Los archivos subidos no se procesan automáticamente. Debe llamar al endpoint /api/process-knowledge para iniciar el procesamiento.
Los archivos se almacenan de forma segura y solo son accesibles por su empresa.
Para listar los archivos subidos, utilice el endpoint /api/knowledge-files.