---
title: "Teams Status"
method: GET
path: "/v1/integrations/teams/status"
tags: ["integrations"]
---

# Teams Status

`GET /v1/integrations/teams/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/teams/status`
- Auth: HTTP bearer

Return the tenant's consent, reachability, and slot state.

Scoped to the bearer principal's tenant; reads the tenant's own installation (if any).

``teams_configured`` means this deployment has the required Microsoft credentials.
``consent_granted`` means an ACTIVE installation exists. ``app_reachable`` means that
installation carries an allowed Bot Connector service URL. Teams supplies that URL only with a
real inbound activity from the workspace, so it proves the app package is installed and Patricia
has been reached there. ``connected`` requires all three conditions because a stored reply
address cannot make Patricia usable after those credentials are removed. The other booleans
report only their observed state. ``slot_held`` means a new Teams workspace cannot connect. It
remains true for a CANCELLED installation as well.

## Headers

- `X-Tenant-Id` string, nullable

## Response `200`

Successful Response

- TeamsStatusResponse: The consent, app reachability, and workspace-slot state for Microsoft Teams.
  - `connected` boolean, required: True when consent exists and Patricia can reply in Teams.
  - `teams_configured` boolean, required: True when this deployment has the Microsoft application credentials required for Teams.
  - `consent_granted` boolean, required: True when an ACTIVE Teams platform installation exists.
  - `app_reachable` boolean, required: True when an allowed Bot Connector service URL is known for the Microsoft workspace.
  - `slot_held` boolean, required: True when the tenant cannot connect a different Microsoft workspace.
  - `platform_tenant_id` string, nullable, required: The Microsoft Entra tenant ID for the active installation, or null.
  - `app_install_deep_link` string, nullable, required: The Teams custom-app install link, or null when Teams is not configured.

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