> ## Documentation Index
> Fetch the complete documentation index at: https://onecli.sh/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Organization Channels API: Slack Integration and Identity

> Connect Slack to your organization, manage shared-app installs, and link Slack users to members with the OneCLI API.

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](https://onecli.sh/docs/integrations/slack.md).

## Related guides

* [Slack: talk to agents in Slack](https://onecli.sh/docs/integrations/slack.md)
* [Self-hosting: deploy OneCLI yourself](https://onecli.sh/docs/self-hosting/overview.md)

## Endpoints

| Endpoint | Method and path | What it does |
| - | - | - |
| [Get the organization's channel integrations](https://onecli.sh/docs/api-reference/organization-channels/get-the-organizations-channel-integrations.md) | `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](https://onecli.sh/docs/api-reference/organization-channels/connect-or-refresh-the-organizations-channel-credential.md) | `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](https://onecli.sh/docs/api-reference/organization-channels/disconnect-the-organizations-channel-credential.md) | `DELETE /org/channels/{provider}` | Disconnect your organization's channel credential. |
| [Get the shared-app setup manifest](https://onecli.sh/docs/api-reference/organization-channels/get-the-shared-app-setup-manifest.md) | `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](https://onecli.sh/docs/api-reference/organization-channels/start-a-shared-app-install.md) | `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](https://onecli.sh/docs/api-reference/organization-channels/disconnect-the-shared-app-install.md) | `DELETE /org/channels/{provider}/shared-install` | Disconnect the shared Slack app install. |
| [Inspect a marketplace install code](https://onecli.sh/docs/api-reference/organization-channels/inspect-a-marketplace-install-code.md) | `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](https://onecli.sh/docs/api-reference/organization-channels/finish-a-marketplace-install.md) | `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](https://onecli.sh/docs/api-reference/organization-channels/link-a-provider-identity-to-a-member.md) | `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](https://onecli.sh/docs/api-reference/organization-channels/remove-an-identity-link.md) | `DELETE /org/channels/{provider}/user-links/{linkId}` | Remove a link between a Slack user and a member. |

## Next steps

* [API overview](https://onecli.sh/docs/api-reference.md): base URLs, authentication, and pagination
* [Errors](https://onecli.sh/docs/api-reference/errors.md): status codes and the error format
* [Editions](https://onecli.sh/docs/api-reference/editions.md): which endpoints each edition serves


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.