Connect a phone number to an agent
Connect an Australian number to an agent through the same path as the onboarding number step: reuse it when the workspace already holds it, adopt it when our carrier account already owns it on this environment's voice connection (a number whose order outlasted the purchase wait), otherwise buy it, then assign it to the agent and record the result on the agent's latest build. Safe to repeat: it never orders a number twice, and an agent that already answers on a number is left alone. An order the carrier is still confirming stays recorded as connecting and settles the next time the workspace's numbers are read. Returns the number's status, or the reason it could not 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/connect_phone_number" \ -H "Content-Type: application/json" \ -d '{ "agent": "string", "phoneNumber": "string" }'{
"phoneNumber": "string",
"agent": "string",
"connected": true,
"property1": null,
"property2": null
}{
"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
}Mark call reviewed POST
Mark a real call as human-reviewed, or un-mark it. Marking stamps you as the reviewer with the current time and saves an optional one-line note; un-marking wipes the reviewer, timestamp, and note so the call reads as honestly unreviewed. Use it to clear a call off the review queue after you've checked it, or to reopen one. The call must be one you can see in this workspace.
Connect Slack channel POST
Connect a Slack channel so call alerts and metric alerts can post to it. Takes the channel's incoming-webhook URL from Slack (Apps → Incoming Webhooks) and returns the channel's `id`, which is what `slackChannelIds` on create_call_alert/update_call_alert accepts. The URL is encrypted before it is stored: it is never returned by this op, never echoed in the approval summary, and no op or model can read it back, only the alert delivery path decrypts it. A URL that is not on https://hooks.slack.com/ is refused rather than stored, because it could never deliver. Requires workspace-admin access. Call list_call_alerts first to see the channels already connected (under `slackChannels`) so you don't connect a duplicate.