---
title: "POST /documentModels/{modelId}:analyze"
method: POST
path: "/documentModels/{modelId}:analyze"
---

# POST /documentModels/{modelId}:analyze

`POST /documentModels/{modelId}:analyze`

Analyzes document with document model.

## Path parameters

- `modelId` string, required

## Query parameters

- `api-version` string, required
- `pages` string
- `locale` string
- `stringIndexType` 'textElements' | 'unicodeCodePoint' | 'utf16CodeUnit'
- `features` string[]
- `queryFields` string[]
- `outputContentFormat` 'text' | 'markdown'
- `output` string[]

## Response `202`

The request has been accepted for processing, but processing has not yet completed.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2023-10-31-preview) `79004296a99a` — 2 warning
  - the optional response header `Retry-After` removed for the status `202`
  - deleted the `query` request parameter `output`
- **2026-07-13** (2023-10-31-preview) `5c827e8b978e` — 1 info
  - added the new optional `query` request parameter `output`
- **2023-11-11** (2023-10-31-preview) `39529146a387` — 2 warning
  - the optional response header `Retry-After` removed for the status `202`
  - deleted the `query` request parameter `output`

[Change history](https://skmtc.dev/azure/apis/ai-documentintelligence/changes/documentModels/:modelId:analyze/post.md)

---

[API](https://skmtc.dev/azure/apis/ai-documentintelligence.md) · [All operations](https://skmtc.dev/azure/apis/ai-documentintelligence/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/ai-documentintelligence/revisions/3f750834da9e/schema)
