Skip to main content
POST
register a call

Authorizations

Authorization
string
header
required

your rumik api key, e.g. rk_live_.... create one in the rumik dashboard.

Body

application/json
agent_id
string
required

the agent to run — its uuid or its ua_… handle. agentId is accepted too.

Example:

"ua_fe3277d8"

Response

the call's id and a single-use token to start it with.

access_token
string

single-use token, prefixed wct_. pass as ?token= when opening the realtime socket, or as accessToken to /v1/webcall.

Example:

"wct_9f8c2b1e4d5a4e6fa7b8c9d0e1f2a3b4"

expires_in
integer

seconds the token stays redeemable.

Example:

300

sample_rate
integer

audio sample rate for a realtime session, in hz. a web call negotiates its own.

Example:

24000

call_id
string<uuid>

the call's id, minted now. it is what session.created and the web call's callId carry once the call starts, what conversations and usage show, and what your tools receive as {call_id}.

Example:

"01a05b4e-2c1d-7a3e-9f10-5b6c7d8e9f01"