La API REST

Claves

Crea una en API keys. La clave se muestra una sola vez; guardala entonces. Cada clave lleva los scopes que elijas, puede fijarse a una sola base de conocimiento y puede tener caducidad.

Envíala como bearer token:

Authorization: Bearer wai_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Enviar un documento

POST /api/v1/ingest
{
  "kb_id": "kb_e0raV5ewROdX",
  "external_id": "articulo-ayuda-42",
  "title": "Politica de devoluciones",
  "content": "# Politica de devoluciones\n\nDevolvemos en 30 dias...",
  "url": "https://example.com/ayuda/devoluciones"
}

external_id es tuyo: es como reconocemos el mismo elemento la proxima vez. Envialo otra vez con el contenido cambiado y el documento se actualiza; envialo igual y no se reindexa nada, que es por lo que un envio completo cada noche casi no cuesta.

Usa POST /api/v1/ingest/batch para hasta 25 elementos en una peticion, y DELETE /api/v1/ingest/{external_id} para eliminar uno.

Comprobar como va

GET /api/v1/kb/{kb_id}/status devuelve cuantos documentos estan indexados, en proceso o fallidos. GET /api/v1/kbs lista las bases de conocimiento que alcanza la clave.

La indexacion es asincrona: un documento se acepta al momento y sirve para responder un instante despues.

Limites

Cada plan tiene un presupuesto diario de peticiones, visible en la pagina de API keys. Una clave que lo supera recibe un 429 con la hora de reinicio.