---
title: "GET /v1/orgs/{orgId}/integrations/slack"
method: GET
path: "/v1/orgs/{orgId}/integrations/slack"
tags: ["Orgs", "Integrations"]
---

# GET /v1/orgs/{orgId}/integrations/slack

`GET /v1/orgs/{orgId}/integrations/slack`

## Request

- Base URL: `https://api.tessl.io`
- URL: `https://api.tessl.io/v1/orgs/{orgId}/integrations/slack`
- Auth: none declared
- TypeScript: <https://skmtc.dev/tessl/apis/tessl-api/docs/v1/orgs/:orgId/integrations/slack/get.ts> (a function with typed inputs; its response is checked against the schema)

The organization's connected Slack workspaces, newest first, and whether this instance can connect another. An organization holds one live connection per Slack workspace and app.

## Path parameters

- `orgId` string, uuid, required

## Headers

- `Authorization` string

## Response `200`

Default Response

- object
  - `links` object, required
    - `self` string, uri, required
  - `data` object, required
    - `id` string, uuid, required
    - `type` 'org-slack-connections', required
    - `attributes` object, required
      - `configured` boolean, required: Whether this instance has a Tessl Slack app, so a Slack workspace can be connected.
      - `connections` object[], required
        - `integrationId` string, uuid, required
        - `slackTeamId` string, required
        - `slackTeamName` string, nullable, required
        - `slackAppId` string, required
        - `reconnectRequired` boolean, required: Whether Slack revoked this connection, because the app was uninstalled from the Slack workspace or its bot token was revoked. A marked connection carries no events; connecting the Slack workspace again replaces it.
        - `installedBy` string, uuid, required
        - `installedByName` string, nullable, required: The username of the member who connected the Slack workspace; null once they are no longer a member of the organization.
        - `createdAt` string, required
        - `updatedAt` string, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

## Changes

- **2026-11-12** `c9a59b80670e`: 1 info
  - added the required property `data/attributes/connections/items/reconnectRequired` to the response with the `200` status
- **2026-11-11** `40be904c23c3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tessl/apis/tessl-api/changes/v1/orgs/:orgId/integrations/slack/get.md)

---

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