---
title: "Verify Microsoft connection capabilities"
method: POST
path: "/api/integrations/microsoft/check"
tags: ["v1", "integrations"]
---

# Verify Microsoft connection capabilities

`POST /api/integrations/microsoft/check`

## Request

- The document declares no server URL.
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/docs/api/integrations/microsoft/check/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- BodyPostV1VerifyMicrosoftConnectionCapabilities
  - `credential_id` string, required

## Response `200`

Successful Response

- MicrosoftAccessCheck
  - `verified` boolean, required
  - `account_type` 'personal' | 'work', nullable, required
  - `capabilities` MicrosoftCapability[], required
    - `service` 'mail' | 'calendar' | 'files' | 'teams' | 'copilot' | 'work_iq', required
    - `name` string, required
    - `status` 'available' | 'permission_needed' | 'admin_required' | 'setup_required' | 'work_account_only' | 'unavailable', required
    - `scopes` string[]
  - `message` string, required
  - `admin_consent_url` string, nullable

## Other responses

- `401`: Authentication required
- `422`: Validation Error

## Changes

- **2026-11-01** `d461506d8824`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/changes/api/integrations/microsoft/check/post.md)

---

[API](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server.md) - [All operations](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/llms.txt) - [OpenAPI document](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/revisions/ab4c69cd5329?raw)