Operations
Operations

Connect Slack channel

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.

POST
/operations/connect_slack_channel

Authorization

bearerAuth
AuthorizationBearer <token>

A personal access token from Settings > API tokens.

In: header

Header Parameters

Idempotency-Key?string

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.

Length1 <= length <= 255

Request 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_slack_channel" \  -H "Content-Type: application/json" \  -d '{    "label": "string",    "webhookUrl": "string",    "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
}

Connect a phone number to an agent POST

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.

Connect an app (workspace) POST

Begin connecting an app at the WORKSPACE level and return an authorization link to finish. Connecting alone arms NO agent, the account exists but every agent still loads nothing until it has its own opt-in. Pass shareWithAllAgents: true to give the account to every agent in the workspace as the connect completes. One-click (platform-managed sign-in) and bring-your-own-KEY apps connect through here and return { redirectUrl, status:'pending' } (open the link, then poll list_workspace_connections). Apps needing the operator's OWN OAuth-app credentials can't be connected through a model tool, they return { needsSecret:true, settingsUrl } pointing to Connected apps in the app, which collects them (secrets never pass through this tool). Requires workspace-admin.