---
title: "List Slack Channels in a workspace."
method: POST
path: "/listChannels"
tags: ["channel"]
---

# List Slack Channels in a workspace.

`POST /listChannels`

Returns a list of public & private channels each containing the ID and name of a channel in the workspace.

## Request body

- object
  - `body` object — Body of the getChannelsIds sls call
    - `arguments` object, required — Container for function arguments.
      - `cursor` string — A cursor to the next page of results.
      - `limit` number — The maximum number of channels to return. Defaults to 50.

## Response `200`

Successful response

- object
  - `channels` object[]
    - `id` string, required — The ID of the channel.
    - `name` string, required — The name of the channel.
  - `nextCursor` string — A cursor to the next page of results

## Other responses

- `500` — Internal Server Error

## Changes

> 45 revisions in range; 1 could not be searched.

- **2025-07-25** `dfc356a225b9` — 1 info
  - endpoint added
- **2025-07-18** `8d0d784763dc` — 1 breaking
  - api path removed without deprecation
- **2025-07-16** `f411c95b89fc` — 2 info
  - added the new optional request property `body/arguments/cursor`
  - added the new optional request property `body/arguments/limit`
- **2025-07-15** `c28a413c6b00` — 1 breaking, 4 info
  - the response property `items/created` became optional for the status `200`
  - api tag `channel` added
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `403`
  - …1 more
- **2025-07-10** `b883cbfe46f6` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/microfox-ai/apis/slack-d/changes/listChannels/post.md)

---

[API](https://skmtc.dev/microfox-ai/apis/slack-d.md) · [All operations](https://skmtc.dev/microfox-ai/apis/slack-d/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/microfox-ai/slack-d/revisions/cd0edf0c2cdf/schema)