Skip to main content
POST
Complete a channel attach with pasted tokens

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
botToken
string
required
Maximum string length: 500
appToken
string

Socket transport.

Maximum string length: 500
signingSecret
string

Events transport.

Maximum string length: 500
appId
string
Maximum string length: 100
transport
enum<string>
Available options:
events,
socket

Response

The completed presence

provider
string
Example:

"slack"

status
string
transport
enum<string>

events = Slack calls OneCLI over HTTPS (needs a public API origin); socket = OneCLI's channel adapter holds a Socket Mode connection.

Available options:
events,
socket
externalId
string

The provider-side app id.

identityRef
string | null
identityName
string | null
tenant
object
managedBy
object | null
groupThreads
object[]
spaces
object[]

Every channel the presence is in or was asked about, with its reach state.

people
object[]

Everyone who reached the agent by direct message, with their standing.