---
title: "Check auth"
method: GET
path: "/v1/providers/ms-teams/{channel_id}/auth_check"
tags: ["Providers", "Microsoft Teams"]
---

# Check auth

`GET /v1/providers/ms-teams/{channel_id}/auth_check`

Check if a connection to Microsoft Teams has been authorized for a given Microsoft Teams tenant object.

## Path parameters

- `channel_id` string, required

## Query parameters

- `ms_teams_tenant_object` string, required

## Response `200`

OK

- MsTeamsAuthCheckResponse — The response from a Microsoft Teams auth check request.
  - `connection` object, required — A Microsoft Teams connection object.
    - `ms_teams_tenant_id` string, nullable — The Microsoft Teams tenant ID for the connected tenant.
    - `ok` boolean, required — Whether the Microsoft Teams connection is valid.
    - `reason` string, nullable — The reason for the Microsoft Teams connection if it is not valid.

## Changes

- **2026-07-14** `de4604427056` — 1 info
  - added the optional property `connection/ms_teams_tenant_id` to the response with the `200` status

[Change history](https://skmtc.dev/knocklabs/apis/knock-api/changes/v1/providers/ms-teams/:channel_id/auth_check/get.md)

---

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