Skip to main content
POST
Attach a channel (guided)

Authorizations

Authorization
string
header
required

A workspace API key (oc_…) or organization API key (oc_org_…). Workspace-scoped endpoints called with an organization key also need X-Workspace-Id.

Path Parameters

agentId
string
required
provider
enum<string>
required

Channel provider. Slack is the only provider today.

Available options:
slack

Body

application/json
transport
enum<string>

Omit to let the deployment posture decide.

Available options:
events,
socket

Response

The presence and what to drive next

presenceId
string
transport
enum<string>
Available options:
events,
socket
installUrl
string | null

Events transport — the one-click "Add to Slack" consent URL.

settingsUrl
string

Socket transport — where the app-level token is generated and the app installed.