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.
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
uuidx-space-id?string
Space to act in. Omit to use the user's default space. Must be a space the user belongs to, otherwise the request is rejected.
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"
}