Ricky logorickyDocs

Update a file

PATCH
/knowledge/files/{file_id}

Changes its title, description or what the agents may do with it. Only a ready file changes; otherwise 409 conflict.

Scope: knowledge:write.

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

Header Parameters

Idempotency-Key?string

Optional. A value you choose, unique per logical write, 8–200 characters: a UUID or an ID from your system such as order-10482-ready. Retrying with the same key and body replays the first response instead of repeating the write.

Length8 <= length <= 200

Request Body

application/json
  1. body

Only the fields you send change. The file must be ready.

title?string

Title the agents see.

Length1 <= length <= 160
description?string

When the agents should use it.

Lengthlength <= 2000
consult_enabled?boolean

Agents may read it to answer.

send_enabled?boolean

Agents may send the file itself.

Response Body

Success.

application/json
  1. response
data*

A document or image the agents can consult or send.

curl -X PATCH 'https://getricky.ai/api/v1/knowledge/files/497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -H 'Idempotency-Key: order-10482-ready' \  -H 'Content-Type: application/json' \  -d '{  "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"  }}