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

# List Slack connections for a project

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

## Request

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

Returns the active (non-revoked, non-deleted) Slack workspace installs for the project, whichever surface installed them. Each connection reports its own surface so callers can label provenance; an alert may deliver through a workspace installed from the other app.

## Path parameters

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

## Response `200`

OK

- ListSlackConnectionsResponseBody
  - `data` PlatformSlackConnection[], nullable, required
    - `created_by` Creator
      - `id` string, required: Creator's user ID
      - `name` string, required: Creator's display name
    - `id` string, required
    - `installed_at` string, date-time, required
    - `project_id` string, required
    - `revoked_at` string, date-time: Set when the install was revoked or soft-deleted; absent for active connections.
    - `scope` string, required: Comma-joined scopes Slack granted on the bot token.
    - `slack_app_id` string, required: Slack app id (e.g. A01234XYZ). Lets callers distinguish which Particle app the bot identity belongs to in the workspace.
    - `slack_team_id` string, required: Slack vendor workspace identifier (e.g. T01234ABC).
    - `slack_team_name` string, required: Slack workspace display name at install time.
    - `surface` 'PLATFORM' | 'RADAR', required: Which Particle Slack app this workspace installed. PLATFORM installs the Particle Slack app; RADAR installs the Radar Slack app. Fixed at install time and inferred from the caller's authenticated surface context (JWT issuer) on /initiate. Provenance only — an alert on either surface can deliver through it, though the message posts as this app's bot. Render it to show where the workspace was connected.

## 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)