Ricky logorickyDocs

List files

GET
/knowledge/files

Documents and images the agents can consult or send, newest first.

Scope: knowledge:read.

Authorization

bearerAuth
headerAuthorizationBearer <token>

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

Response Body

Success.

application/json
  1. response
data*array<>
next_cursor*|

Pass as cursor for the next page; null on the last page.

curl -X GET 'https://getricky.ai/api/v1/knowledge/files'
{  "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"    }  ],  "next_cursor": "string"}