---
title: "Create MLC requests"
method: POST
path: "/mlc"
tags: ["Multi-Level Classification (MLC)"]
---

# Create MLC requests

`POST /mlc`

## Request

- Base URL: `https://us.app.zuva.ai/api/v2`
- URL: `https://us.app.zuva.ai/api/v2/mlc`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/zuva/apis/zuva-docai/docs/mlc/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates an MLC request for each of the specified files.

## Request body

- CreateMLCRequest
  - `file_ids` string[], required: The files to classify

## Response `202`

See response body for status of each request.

- MLCRequestsAccepted
  - `file_ids` MLCStatus[], required
    - `classifications` string[]
    - `is_amendment` boolean
    - `is_master_agreement` boolean
    - `language` MLCLanguage
      - `code` string, required
      - `name` string, required
    - `error` HttpErrorDetails
      - `code` string, required: A unique string identifying the error.
      - `message` string, required: An error message providing more details and potential steps to resolve.
    - `file_id` string, required
    - `request_id` string, required
    - `status` 'queued' | 'processing' | 'complete' | 'failed', required

## Other responses

- `400`: Malformed request or missing/invalid `file_ids` attribute.
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error

## Changes

- **2023-12-13** `51f2a4c5de2e`: 5 info
  - api tag `Multi-Level Classification (MLC)` added
  - api tag `Multi-level Classification` removed
  - added the optional property `file_ids/items/is_amendment` to the response with the `202` status
  - added the optional property `file_ids/items/is_master_agreement` to the response with the `202` status
  - …1 more
- **2022-12-13** `7cace20deba7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zuva/apis/zuva-docai/changes/mlc/post.md)

---

[API](https://skmtc.dev/zuva/apis/zuva-docai.md) - [All operations](https://skmtc.dev/zuva/apis/zuva-docai/llms.txt) - [OpenAPI document](https://skmtc.dev/zuva/apis/zuva-docai/revisions/7397ad071d55?raw)