---
title: "POST /documentClassifiers:build"
method: POST
path: "/documentClassifiers:build"
---

# POST /documentClassifiers:build

`POST /documentClassifiers:build`

Builds a custom document classifier.

## Query parameters

- `api-version` string, required

## Request body

- BuildDocumentClassifierRequest — Request body to build a new custom document classifier.
  - `classifierId` string, required — Unique document classifier name.
  - `description` string — Document classifier description.
  - `baseClassifierId` string — Base classifierId on top of which to train the classifier.
  - `docTypes` object, required — List of document types to classify against.
  - `allowOverwrite` boolean — Allow overwriting an existing classifier with the same name.

## Response `202`

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

## Other responses

- `default` — An unexpected error response.

## Changes

> 6 revisions in range; 1 could not be searched.

- **2023-11-11** (2023-10-31-preview) `39529146a387` — 1 warning
  - the optional response header `Retry-After` removed for the status `202`

[Change history](https://skmtc.dev/azure/apis/ai-documentintelligence/changes/documentClassifiers:build/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)