---
title: "Slack Status"
method: GET
path: "/v1/integrations/slack/status"
tags: ["integrations"]
---

# Slack Status

`GET /v1/integrations/slack/status`

## Request

- Base URL: `https://api.patricia.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.patricia.app/v1/integrations/slack/status`
- Auth: HTTP bearer

Whether this tenant has a Slack installation. Drives the connected/disconnected UI.

Reads the chat-platform install (the Slack bot / PlatformInstallation), NOT a Slack
*tool* integration account: those are different things, and the Channels card means
the former.

The response carries the workspace (team) id and Patricia's own bot user id, the pair a
client needs to deep-link into the direct message with her. The bot user id is null on an
install recorded before it was stored, so a client must have a workspace-level fallback.

## Headers

- `X-Tenant-Id` string, nullable

## Response `200`

Successful Response

- SlackStatusResponse: Whether this tenant has a live Slack install, plus the ids to deep-link into it.
  - `connected` boolean, required: True when an ACTIVE Slack platform installation exists for the tenant.
  - `platform_tenant_id` string, nullable, required: The Slack workspace (team) id, or null when there is no live install.
  - `platform_bot_user_id` string, nullable, required: Patricia's own Slack user id, used to open the direct message with her. Null when there is no live install, and also null for an older install recorded before the id was stored.

## Other responses

- `422`: Validation Error

---

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