---
title: "the Slack channels an agent is shared in, and whether the caller can share it"
method: GET
path: "/w/{workspace}/slack_agents/agent_channels/{path}"
tags: ["slack_agents"]
---

# the Slack channels an agent is shared in, and whether the caller can share it

`GET /w/{workspace}/slack_agents/agent_channels/{path}`

## Request

- Base URL: `/api` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/w/{workspace}/slack_agents/agent_channels/{path}`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `token`

## Path parameters

- `workspace` string, required
- `path` string, required

## Response `200`

the agent's Slack channels

- object
  - `slack_team_name` string: the connected Slack workspace; absent when Slack is not connected
  - `signing_secret_set` boolean, required: agents answer in Slack only when the server has the Slack app's signing secret (SLACK_SIGNING_SECRET)
  - `bot_name` string: the bot's Slack handle; absent when Slack can't be reached
  - `missing_scopes` string[], required: agent scopes the workspace's Slack connection lacks, so it must be reconnected with AI agents enabled
  - `runs_as` string: who the agent runs as (its on_behalf_of); absent unless it runs on behalf of someone
  - `anyone` boolean, required: whether anyone in its channels can ask it (its slack_anyone, kept only while it runs on behalf of someone), rather than workspace members only
  - `can_share` boolean, required: whether the caller can change the agent's channels, as anyone who can edit it can
  - `channels` SlackAgentChannel[], required
    - `channel_id` string, required
    - `channel_name` string, required
    - `agent_path` string, required
    - `is_default` boolean, required: whether the agent answers bot mentions in the channel that name no agent

## Changes

- **2026-10-19** `04340d246ff6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/windmill/apis/windmill-api/changes/w/:workspace/slack_agents/agent_channels/:path/get.md)

---

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