Skip to main content
GET
Get a webhook endpoint

Authorizations

Authorization
string
header
required

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_...

Path Parameters

id
string<uuid>
required

The webhook endpoint uuid.

Response

The endpoint.

id
string<uuid>
required
Example:

"7f8e9d0c-1b2a-4c3d-8e4f-5a6b7c8d9e0f"

url
string<uri>
required
Example:

"https://crm.acme.example/hooks/ryvo"

events
enum<string>[]
required
Available options:
conversation.started,
conversation.ended,
analysis.ready,
call.initiated,
call.completed,
call.failed
Example:
is_active
boolean
required
consecutive_failures
integer
required
Example:

0

auto_disabled_at
string<date-time> | null
required

Set when Ryvo switched the endpoint off after repeated exhausted deliveries.

auto_disabled_reason
string | null
required
previous_secret_expires_at
string<date-time> | null
required

After a rotation, until when the previous secret still signs.

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