Set website surface
Switch one of the agent's website surfaces on or off: 'text' (the embeddable chat panel, via /api/embed/chat) or 'voice' (the embeddable call pill, via /api/embed/start). The brain, prompt, tools, knowledge base, is shared with the phone agent; a surface only decides how that brain reaches people, and every piece of copy lives in Build. You still need a publishable key (create_publishable_key) with the website's origin allow-listed before a page can connect.
Authorization
bearerAuth A personal access token from Settings > API tokens.
In: header
Header Parameters
A key you choose, such as a UUID, that makes this POST safe to retry. Within 24 hours the same key and request answers with the first successful answer and runs nothing, the same key with a different request answers 422 idempotency_key_reused, and a key whose request is still running answers 409 idempotency_key_in_use. A failed request keeps nothing, so the same key runs it again.
1 <= length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/operations/set_channel" \ -H "Content-Type: application/json" \ -d '{ "channelType": "text", "enabled": true, "agent": "string" }'{}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}Set caller routing POST
Mark one caller (by phone number) for priority routing: an inbound call from them is bridged straight to a human, skipping the agent. Creates the caller's profile if none exists yet. Pass destination to route them somewhere other than the agent's own transfer number; omit it to use the agent's transfer_to_human destination at call time. Refused if auto_transfer is true and neither this caller's destination nor the agent's own transfer_to_human is set: call add_builtin_tool with transfer_to_human (or set_builtin_config) first, or pass a destination here. Use when the operator says things like 'always put Jordan straight through to a person' or 'route calls from +61400000000 to reception'.
Set chat hand-off POST
Hand website chats to a person by text. When a visitor writes in the chat widget, every recipient gets an SMS from the sender number with a short ref (e.g. KQ47), the visitor's first message and a link to the full chat. The AI keeps answering until someone replies to that text: their reply appears in the visitor's chat under their name, the AI stops answering that chat, and the visitor's later messages are texted to whoever replied. A reply that starts with a ref goes to that chat; otherwise it goes to the newest chat that texted that person. One alert per chat, at most 10 a workspace an hour. Every text is billed to the workspace as SMS usage. Applies at once, with no publish. Needs the website chat switched on (set_channel) to do anything.