Ricky logorickyDocs

Subir un archivo

POST
/knowledge/files

Inicia una carga en tres pasos: esta llamada responde el archivo, uploading, y una upload_url; envía los bytes con PUT a esa URL; luego llama a POST /knowledge/files/{file_id}/complete.

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 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

Inicia una carga. Ricky responde adónde enviar los bytes con PUT.

title*string

Título que ven los agentes.

Longitud1 <= length <= 160
description?string

Cuándo deben usarlo los agentes.

Longitudlength <= 2000
Predeterminado""
filename*string

Nombre del archivo, con su extensión.

Longitud1 <= length <= 255
mime_type*string

Tipo de archivo: PDF, Word o Excel de hasta 100 MB; JPEG o PNG de hasta 5 MB.

Uno de"application/pdf""application/vnd.openxmlformats-officedocument.wordprocessingml.document""application/vnd.openxmlformats-officedocument.spreadsheetml.sheet""image/jpeg""image/png"
size_bytes*integer

Tamaño exacto del archivo que vas a subir.

Rango1 <= value <= 9007199254740991

Cuerpo de la respuesta

Éxito.

application/json
  1. response
data*

Un archivo que espera sus bytes, y dónde ponerlos.

curl -X POST 'https://getricky.ai/api/v1/knowledge/files' \  -H 'Idempotency-Key: order-10482-ready' \  -H 'Content-Type: application/json' \  -d '{  "title": "Catálogo de lentes 2026",  "filename": "catalogo-2026.pdf",  "mime_type": "application/pdf",  "size_bytes": 482133}'
{  "data": {    "file": {      "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"    },    "upload_url": "https://storage.example.com/upload/sign/media/d9e0f1a2-b3c4-4d5e-8f6a-7b8c9d0e1f2a/knowledge/f1a2b3c4-d5e6-4f7a-8b9c-0d1e2f3a4b5c.pdf?token=…"  }}