---
title: "Complete a Microsoft Teams disconnect teardown callback"
method: POST
path: "/messaging/teams/disconnect-teardown/callback"
tags: ["Messaging"]
---

# Complete a Microsoft Teams disconnect teardown callback

`POST /messaging/teams/disconnect-teardown/callback`

## Request

- Base URL: `https://api.xfa.tech`
- URL: `https://api.xfa.tech/messaging/teams/disconnect-teardown/callback`
- Auth: HTTP bearer

## Request body

- TeamsDisconnectTeardownCallbackRequest
  - `organization_id` string, required: The ID of the organization completing Teams disconnect teardown
  - `state` string, required: The admin-consent state returned by Microsoft
  - `code` string, required: The delegated authorization code returned by Microsoft

## Response `200`

Returns Teams disconnect teardown results

- TeamsDisconnectTeardownCallbackResponse
  - `catalog` 'deleted' | 'skipped_shared_tenant' | 'skipped_missing_catalog' | 'error', required: Catalog app teardown status
  - `tenant_shared` boolean, required: Whether another active Teams connection shares the Microsoft tenant
  - `entra` object, required
    - `show` boolean, required
    - `app_id` string, required
    - `app_name` string, required
    - `deep_link` string, required
  - `uninstall` 'queued' | 'skipped', required: User-installation teardown status

## Other responses

- `400`: Invalid request
- `403`: MFA required or invalid
- `404`: Connection not found

---

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