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

# POST /analyze-text/jobs

`POST /analyze-text/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

- AnalyzeTextJobsInput — The input object for the analyze text 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.
      - `text` string, required — The input text to process.
      - `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. (Following only applies to 2023-04-15-preview and above) For Auto Language Detection, use \"auto\". If not set, use \"en\" for English as default.
  - `tasks` AnalyzeTextLROTask[], required — List of tasks to be performed as part of the LRO.
    - `taskName` string — task name
    - `kind` 'SentimentAnalysis' | 'EntityRecognition' | 'PiiEntityRecognition' | 'KeyPhraseExtraction' | 'EntityLinking' | 'Healthcare' | 'CustomEntityRecognition' | 'CustomSingleLabelClassification' | 'CustomMultiLabelClassification' | 'ExtractiveSummarization' | 'AbstractiveSummarization', required — The kind of the long running analyze text tasks supported.
  - `defaultLanguage` string — Default language to use for records requesting automatic language detection.
  - `cancelAfter` number, float — Optional duration in seconds after which the job will be canceled if not completed.

## 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.net/azure/apis/cognitiveservices-languageanalyzetext.md) · [All operations](https://skmtc.net/azure/apis/cognitiveservices-languageanalyzetext/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/cognitiveservices-languageanalyzetext/revisions/87a54ae2fce6/schema)