Organization Channels API: Slack Integration and Identity

Organization channels connect chat tools such as Slack to OneCLI so people can talk to agents where they already work. These endpoints manage the Slack credential, the shared-app install, and links between Slack users and organization members. Identity links matter: they tell OneCLI which member sent a message, so the agent runs with that member’s access. For setup steps, see Slack.

Endpoints

Endpoint	Method and path	What it does
Get the organization’s channel integrations	`GET /org/channels`	Get your organization’s channel integrations, identity links, adapter health, and shared-app status in one call.
Connect or refresh the organization’s channel credential	`PUT /org/channels/{provider}/credentials`	Connect or refresh your Slack app configuration token so OneCLI can create a dedicated Slack app for each agent on your behalf.
Disconnect the organization’s channel credential	`DELETE /org/channels/{provider}`	Disconnect your organization’s channel credential.
Get the shared-app setup manifest	`GET /org/channels/{provider}/shared-manifest`	Get the manifest a self-hosted operator uses to create a deployment-wide shared Slack app.
Start a shared-app install	`POST /org/channels/{provider}/shared-install`	Start a shared Slack app install by getting the Add to Slack consent URL.
Disconnect the shared-app install	`DELETE /org/channels/{provider}/shared-install`	Disconnect the shared Slack app install.
Inspect a marketplace install code	`POST /org/channels/{provider}/finish-install/inspect`	Inspect a Slack marketplace install code to see which workspace it belongs to before you bind it.
Finish a marketplace install	`POST /org/channels/{provider}/finish-install`	Finish a Slack marketplace install by binding the inspected claim to your organization, so agents can start answering in Slack.
Link a provider identity to a member	`POST /org/channels/{provider}/user-links`	Link a Slack user to an organization member so their messages run with that member’s access.
Remove an identity link	`DELETE /org/channels/{provider}/user-links/{linkId}`	Remove a link between a Slack user and a member.

Next steps

API overview: base URLs, authentication, and pagination
Errors: status codes and the error format
Editions: which endpoints each edition serves

Workspace

Organization

Enterprise

Platform

Organization Channels API: Slack Integration and Identity

Endpoints

Next steps

​Related guides

​Endpoints

​Next steps

Related guides

Endpoints

Next steps