Ricky logorickyDocs

Completar una carga

POST
/knowledge/files/{file_id}/complete

Compara los bytes cargados con el tipo y el tamaño declarados, lee el contenido para los agentes y responde el archivo, ready. Leer un PDF largo puede tardar minutos. Completar un archivo ready no cambia nada.

Permiso: knowledge:write.

Autorización

bearerAuth
headerAuthorizationBearer <clave>

Una clave de API de la organización, rky_live_…, creada en Configuración → API. Envíala solo desde un servidor.

Parámetros de ruta

file_id*string

ID del archivo.

Formatouuid

Parámetros de cabecera

Idempotency-Key?string

Opcional. Un valor que eliges, único por escritura lógica, de 8 a 200 caracteres: un UUID o un ID de tu sistema, como order-10482-ready. Reintentar con la misma clave y el mismo cuerpo repite la primera respuesta en lugar de repetir la escritura.

Longitud8 <= length <= 200

Cuerpo de la solicitud

application/json
  1. body

El cuerpo es opcional.

consult_enabled?boolean

Los agentes pueden leerlo para responder. Se ignora cuando Ricky no lee contenido útil.

Predeterminadotrue
send_enabled?boolean

Los agentes pueden enviar el archivo mismo.

Predeterminadotrue

Cuerpo de la respuesta

Éxito.

application/json
  1. response
data*

Un documento o una imagen que los agentes pueden consultar o enviar.

curl -X POST 'https://getricky.ai/api/v1/knowledge/files/497f6eca-6276-4993-bfeb-53cbbbba6f08/complete' \  -H 'Idempotency-Key: order-10482-ready' \  -H 'Content-Type: application/json' \  -d '{  "consult_enabled": true,  "send_enabled": false}'
{  "data": {    "id": "f1a2b3c4-d5e6-4f7a-8b9c-0d1e2f3a4b5c",    "title": "Catálogo de lentes 2026",    "description": "Precios y modelos vigentes.",    "filename": "catalogo-2026.pdf",    "mime_type": "application/pdf",    "size_bytes": 482133,    "status": "uploading",    "consult_enabled": true,    "send_enabled": true,    "page_count": 12,    "preview": "Catálogo 2026. Lentes de sol…",    "extraction_error": null,    "download_url": null,    "created_at": "2026-10-14T15:30:00.000Z",    "updated_at": "2026-10-14T15:30:00.000Z"  }}