---
title: "List Slack channel bindings"
method: GET
path: "/api/v1/slack_channel_bindings"
---

# List Slack channel bindings

`GET /api/v1/slack_channel_bindings`

Returns a page of Slack channel bindings visible to the authenticated user.
Results can be filtered by integration, team, agent, or organization. Omit all
filter params to retrieve every binding the caller can see.

Pagination is page-based. Pass `page` and `per_page` to navigate large result
sets. `page` must be a positive integer; `per_page` must be between 1 and 100.
Invalid values return 400.

## Query parameters

- `per_page` integer
- `page` integer
- `team` string[]
- `org` string[]
- `agent` string[]
- `integration` string[]

## Response `200`

Successful response

- SlackChannelBindingListResponse — Paginated list of Slack channel bindings for the requested integration or team. Use the `page` and `per_page` fields to navigate pages of results.
  - `data` SlackChannelBinding[], required — Array of Slack channel binding objects for the current page.
    - `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.
  - `page` integer, required — Current page number (1-indexed).
  - `per_page` integer, required — Maximum number of bindings returned per page.
  - `total_count` integer, required — Total number of Slack channel bindings matching the query across all pages.
  - `total_pages` integer, required — Total number of pages available at the current `per_page` size.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden

---

[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/revisions/a8772b442f86/schema)