---
title: "Retrieve a Slack channel binding"
method: GET
path: "/api/v1/slack_channel_bindings/{channel}"
---

# Retrieve a Slack channel binding

`GET /api/v1/slack_channel_bindings/{channel}`

Returns the Slack channel binding identified by a Slack channel ID and workspace
team ID pair. Use this endpoint to look up the team and agents currently bound
to a specific Slack channel.

The `channel` path parameter is the Slack channel ID; `slack_team_id` identifies
the Slack workspace the channel belongs to, disambiguating channels with the same
ID across workspaces. Both parameters are required. Returns 404 if no binding
exists for the given pair or the associated Slack integration is not visible to
the caller.

## Path parameters

- `channel` string, required

## Query parameters

- `slack_team_id` string, required

## Response `200`

Successful response

- SlackChannelBinding — A binding that connects a Slack channel to an ArchAstro team and one or more agents, enabling those agents to receive and respond to messages in that channel.
  - `agents` string[] — IDs of the agents attached to this binding. Empty array when no agents are assigned.
  - `channel` string — Slack channel ID (e.g. `C01234ABCDE`) that this binding targets.
  - `customer_label` string — Human-readable label identifying the customer, derived from the binding's embedded config. `null` when not set.
  - `id` string, required — Unique identifier for this Slack channel binding.
  - `integration` string — ID of the Slack integration that owns this binding.
  - `is_ext_shared_cached` boolean — Cached value of Slack's `is_ext_shared` flag for this channel. May be stale relative to Slack's current state.
  - `team` string — ID of the ArchAstro team this channel is bound to.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — The Slack integration referenced by this binding is not visible to the caller
- `404` — Slack channel binding not found
- `422` — Invalid parameters

---

[API](https://skmtc.net/archastro/apis/archastro-platform-api.md) · [All operations](https://skmtc.net/archastro/apis/archastro-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/archastro/archastro-platform-api/versions/a8772b442f86/schema)