Ricky logorickyDocs

Get a file

GET
/knowledge/files/{file_id}

One file; a ready one carries a download_url.

Scope: knowledge:read.

Authorization

bearerAuth
headerAuthorizationBearer <token>

An organization API key, rky_live_…, created in Settings → API. Send it only from a server.

Path Parameters

file_id*string

File ID.

Formatuuid

Response Body

Success.

application/json
  1. response
data*

A document or image the agents can consult or send.

curl -X GET 'https://getricky.ai/api/v1/knowledge/files/497f6eca-6276-4993-bfeb-53cbbbba6f08'
{  "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"  }}