> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mithunai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Read the Microsoft Teams connection

> Which Microsoft Teams organisation your organisation connected, and which assistant answers it.

Requires `credential.read`: the owner or admin role. `data` is `null` when no Teams organisation is connected.

> [!WARNING]
>
> Microsoft Teams in MITHUNAI is in **beta**. These routes answer `404` until your deployment's
> operator registers the Azure Bot and sets its redirect address.

## Response

**data** `object | null` *required*

The connection: `platform` (`teams`), `workspace_id` (the Microsoft Entra tenant id),
`workspace_name`, `assistant_id`, `installed_at`, and `approvals_conversation` -- whether an owner
or admin chose a Teams conversation for approval cards. Nothing secret is kept for Teams.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.