Set channels
Declare which channels the agent serves: 'voice' (phone numbers and the website call pill, billed per minute) and/or 'text' (the website chat widget and share link, billed per reply). At least one. Turning 'text' off switches the chat widget off and turning it on switches it on; turning 'voice' off switches the call pill off. Voice settings stay stored on a chat-only agent, hidden in the editor. A chat agent must run on a model priced per reply (validate_agent reports it).
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_agent_channels" \ -H "Content-Type: application/json" \ -d '{ "channels": [ "voice" ], "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
}Search the docs POST
Search the public product docs and return the best-matching sections, each with its title, its docs link and its text. Use it to answer how the platform works (a setting, a channel, a limit, billing, what an error means) instead of guessing, and give the user the link. It reads only the published docs; it knows nothing about this agent's own config, which get_agent returns.
Set connected app scope POST
Give this agent a connected app, and choose which of its tools it can call. A workspace connects an app once (on the Connected apps page, agent_id NULL) and that is the ACCOUNT, not a grant: it arms no agent by itself. This op writes THIS AGENT'S opt-in row against that account, and that row is the only thing the runtime reads, an agent without one loads none of the app's tools. **The app must already be connected for the workspace**, this op can't connect a new app, only opt an agent into an existing one (a not-connected toolkit returns a 409). Use `enabled: false` to stop this agent loading the app while the workspace account stays connected for the others. Use `allowedTools` to trim the tools the agent loads: `null` = the recommended subset (the fast default, DON'T load a whole 800-tool toolkit), a list = exactly those slugs, `[]` = none. Omit a field to leave it unchanged.