Skip to main content
GET
Get an agent version

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 Ryvo uuid of the agent.

Ejemplo:

"4d0f3c2a-6b7e-4a1c-9f2d-1e2b3c4d5e6f"

version
integer
requerido

The version number (1 or higher). A malformed or unknown version is 404.

Rango requerido: x >= 1
Ejemplo:

3

Respuesta

The version.

version
integer
requerido
Ejemplo:

3

created_at
string<date-time>
requerido
system_prompt
string
requerido
Ejemplo:

"You are the receptionist of Acme Dental. Book appointments and answer questions about opening hours."

first_message
string
requerido
Ejemplo:

"Hi, this is Acme Dental. How can I help you?"

language
string | null
requerido
Ejemplo:

"es-MX"

llm
object
requerido

Which model answers. provider and model are validated against the catalog and your plan when saving (see GET /v1/models).

stt
object
requerido

Speech recognition. settings and sample_rate are provider-specific and validated when saving.

voice
object
requerido

Text to speech. A voice_id is required to publish a voice agent.

knowledge_base
object
requerido

Which documents and folders the agent consults. Ownership is verified when saving.

dynamic_variables
object
requerido
Ejemplo:
conversation
object
requerido

Session limits, recording, turn policy, audio, pronunciation and calling hours. Unknown keys are kept.

tool_ids
string<uuid>[]
requerido