Ricky logorickyDocs

Actualizar un archivo

PATCH
/knowledge/files/{file_id}

Cambia su título, su descripción o lo que los agentes pueden hacer con él. Solo cambia un archivo ready; si no, 409 conflict.

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

Solo cambian los campos que envías. El archivo debe estar ready.

title?string

Título que ven los agentes.

Longitud1 <= length <= 160
description?string

Cuándo deben usarlo los agentes.

Longitudlength <= 2000
consult_enabled?boolean

Los agentes pueden leerlo para responder.

send_enabled?boolean

Los agentes pueden enviar el archivo mismo.

Cuerpo de la respuesta

Éxito.

application/json
  1. response
data*

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

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