---
title: "List channels for a Slack connection"
method: GET
path: "/v1/projects/{projectId}/slack/connections/{id}/channels"
tags: ["Slack Connections", "tier:standard"]
---

# List channels for a Slack connection

`GET /v1/projects/{projectId}/slack/connections/{id}/channels`

## Request

- Base URL: `https://api.particle.pro`
- URL: `https://api.particle.pro/v1/projects/{projectId}/slack/connections/{id}/channels`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Refreshes the channel cache via Slack conversations.list and returns the channels the bot can see. Includes public and private channels; DMs are excluded.

## Path parameters

- `projectId` string, required: Project ID (base62-encoded).
- `id` string, required: Slack connection ID (base62-encoded).

## Response `200`

OK

- ListSlackConnectionChannelsResponseBody
  - `data` PlatformSlackChannel[], nullable, required
    - `name` string, required
    - `slack_channel_id` string, required: Slack vendor channel id (e.g. C01234XYZ for public, G... for private).

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/particle/apis/particle-api.md) · [All operations](https://skmtc.dev/particle/apis/particle-api/llms.txt) · [OpenAPI document](https://skmtc.dev/particle/apis/particle-api/revisions/416ba82ab9d7?raw)