---
title: "Read Slack assistant setup"
method: GET
path: "/v1/mcp-connections/{connectionId}/slack-assistant"
tags: ["Authentication"]
---

# Read Slack assistant setup

`GET /v1/mcp-connections/{connectionId}/slack-assistant`

Read connector configuration, organization eligibility, recent activity metrics, and the Slack app manifest. Only workspace admins can read setup; stored credentials are never returned.

## Path parameters

- `connectionId` string, typeid, required

## Response `200`

Slack assistant setup.

- object
  - `enabled` boolean, required
  - `installed` boolean, required
  - `teamId` string, nullable, required
  - `rolloutEnabled` boolean, required — Whether the platform admin enabled Slack Assistant for this organization.
  - `hasSigningSecret` boolean, required
  - `eligible` boolean, required
  - `webAccess` boolean, required
  - `channelIds` string[], required
  - `shadowMode` boolean, required
  - `dailyLimit` integer, required
  - `model` string, nullable, required — Model chosen for headless runs, or null for the runner default.
  - `defaultModel` string, nullable, required — The headless runner's default model, when this workspace uses it.
  - `models` object[], required — Models the headless runner can use; empty when the workspace doesn't use the headless runner.
    - `id` string, required
    - `name` string, required
  - `metrics` object, required
    - `completed` integer, required
    - `failed` integer, required
    - `active` integer, required
    - `awaitingConnection` integer, required
    - `helpful` integer, required
    - `needsWork` integer, required
    - `firstTextMedianMs` number, nullable, required
    - `finalMedianMs` number, nullable, required
    - `sampledEvents` integer, required
  - `manifest` object, required — Slack app manifest to import when configuring the bot.

## Other responses

- `400` — Invalid parameters or incomplete Slack setup.
- `401` — Authentication required.
- `403` — Admin access, recent verification, or Slack eligibility required.
- `404` — Organization or connection not found.

## Changes

- **2026-10-01** `df3754993784` — 1 info
  - added the optional property `anyOf[#/components/schemas/InvalidRequestError]/message` to the response with the `400` status
- **2026-10-01** `406852f37cc0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/openworklabs/apis/den-api/changes/v1/mcp-connections/:connectionId/slack-assistant/get.md)

---

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