Skip to main content
PATCH
Update a document

Autorizaciones

Authorization
string
header
requerido

A Bearer token. Create keys in the portal under Settings > API keys (https://app.ryvo.so/developers). The token has the form ryvo_live_<64 hex characters> and is shown once.

Header: Authorization: Bearer ryvo_live_...

Parámetros de ruta

id
string<uuid>
requerido

The document uuid.

Cuerpo

application/json
title
string
Required string length: 1 - 200
folder_id
string<uuid> | null

null moves the document to the root.

auto_refresh
boolean

Only accepted on url documents.

Respuesta

The document after the update.

id
string<uuid>
requerido
Ejemplo:

"9b1c2d3e-4f50-4a6b-8c7d-0e1f2a3b4c5d"

title
string
requerido
Ejemplo:

"Price list 2026.pdf"

source
enum<string>
requerido
Opciones disponibles:
upload,
url
Ejemplo:

"upload"

source_url
string | null
requerido
Ejemplo:

null

mime
string | null
requerido
Ejemplo:

"application/pdf"

bytes
integer
requerido
Ejemplo:

184320

status
enum<string>
requerido
Opciones disponibles:
processing,
ready,
error
Ejemplo:

"ready"

folder_id
string<uuid> | null
requerido
auto_refresh
boolean
requerido

Only meaningful on url documents.

last_refreshed_at
string<date-time> | null
requerido
last_refresh_error
string | null
requerido
chunks
integer
requerido

Indexed fragments. The visible proof that the document is searchable.

Ejemplo:

37

agents
object[]
requerido

The agents whose published version consults this document, directly or through its folder.

created_at
string<date-time>
requerido
updated_at
string<date-time>
requerido