---
title: "POST /messages/conversations/{conversationId}:analyze"
method: POST
path: "/messages/conversations/{conversationId}:analyze"
tags: ["ConversationThread"]
---

# POST /messages/conversations/{conversationId}:analyze

`POST /messages/conversations/{conversationId}:analyze`

Get AI Analysis of a conversation.

## Path parameters

- `conversationId` string, required

## Query parameters

- `api-version` string, required

## Headers

- `Repeatability-Request-ID` string
- `Repeatability-First-Sent` string, date-time
- `x-ms-client-request-id` string, uuid

## Response `200`

The request has succeeded.

- GetConversationThreadAnalysisResult — Result of the get conversation messages AI Analysis operation.
  - `summary` string, required — The AI summary of the conversation messages.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2023-08-24-preview) `cebf80ab8712` — 1 breaking
  - api path removed without deprecation
- **2026-07-13** (2023-08-24-preview) `1b6c73c628f1` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/communication-messages/changes/messages/conversations/:conversationId:analyze/post.md)

---

[API](https://skmtc.dev/azure/apis/communication-messages.md) · [All operations](https://skmtc.dev/azure/apis/communication-messages/llms.txt) · [OpenAPI document](https://skmtc.dev/azure/apis/communication-messages/revisions/ec11c913a0e6?raw)
