---
title: "POST /analyze-documents/jobs"
method: POST
path: "/analyze-documents/jobs"
---

# POST /analyze-documents/jobs

`POST /analyze-documents/jobs`

Submit a collection of text documents for analysis. Specify one or more unique tasks to be executed as a long-running operation.

## Query parameters

- `api-version` string, required

## Request body

- AnalyzeDocumentJobsInput — The input object for the analyze documents LRO.
  - `displayName` string — Name for the task.
  - `analysisInput` MultiLanguageAnalysisInput, required — Collection of input documents to be analyzed by the service.
    - `documents` MultiLanguageInput[] — The input documents to be analyzed.
      - `id` string, required — A unique, non-empty document identifier.
      - `source` DocumentLocation, required — Contains the location of the document.
        - `kind` 'AzureBlob' | 'AzureContainer' | 'AzureContainerFolder', required — Enumeration of supported document locations.
        - `location` string, required — The location of the document.
      - `target` DocumentLocation, required — Contains the location of the document.
        - `kind` 'AzureBlob' | 'AzureContainer' | 'AzureContainerFolder', required — Enumeration of supported document locations.
        - `location` string, required — The location of the document.
      - `language` string — (Optional) This is the 2 letter ISO 639-1 representation of a language. For example, use \"en\" for English; \"es\" for Spanish etc. If not set, use \"en\" for English as default.
  - `tasks` AnalyzeDocumentsLROTask[], required — List of tasks to be performed as part of the LRO.
    - `taskName` string — task name
    - `kind` 'PiiEntityRecognition' | 'ExtractiveSummarization' | 'AbstractiveSummarization', required — The kind of the long running analyze documents tasks supported.
  - `defaultLanguage` string — Default language to use for records.

## Response `202`

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

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.dev/azure/apis/cognitiveservices-languageanalyzedocuments.md) · [All operations](https://skmtc.dev/azure/apis/cognitiveservices-languageanalyzedocuments/llms.txt) · [OpenAPI document](https://skmtc.dev/azure/apis/cognitiveservices-languageanalyzedocuments/revisions/41f9c06e9f60?raw)