SessionsInvite operator
Invite a live operator into an ongoing conversation — transfer to a human (SKN-308). Called by the worker once the agent decided to transfer. Does NOT wait for the operator to answer — it returns as soon as the provider accepted the request. The worker sees the pickup itself: the participant shows up in the very room it sits in, carrying the role attribute. Failure to reach the operator is reported by the backend through room metadata, because "the participant never arrived" has nothing to observe.
The role alone is not enough: the handler also verifies that the session belongs to the caller, and that the requested rule is an operator-transfer rule of that same agent.
Authorization
Bearer AuthorizationBearer <token>
JWT Authorization header using Bearer scheme
In: header
Header Parameters
X-Session-Id?string
Ongoing conversation, from the X-Session-Id header.
Format
uuidRequest Body
application/json
Rule the agent picked, by index, plus the summary it composed.
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://api.speaknode.com/api/Sessions/invite-operator" \ -H "Content-Type: application/json" \ -d '{}'{
"success": true,
"call_id": "0d0a16ab-a508-4d58-bf24-5dc3cb248f3e",
"error": "string"
}