---
title: "Create a Classifier"
method: POST
path: "/v1/classifiers"
tags: ["Classify"]
---

# Create a Classifier

`POST /v1/classifiers`

## Request

- Base URL: `https://api.documentpro.ai`
- URL: `https://api.documentpro.ai/v1/classifiers`
- Auth: API key in header `x-api-key`

A Classifier is a reusable, named set of categories. Create once, then run it against many documents with POST /v1/classifiers/{classifier_id}/classify.

## Request body

- ClassifierCreateRequest
  - `name` string, required
  - `configs` ClassifierConfigs, required
    - `classes` ClassCategory[], required
      - `label` string, required
      - `description` string, required
    - `classifier_type` string
    - `query_model` 'gpt-4o-mini' | 'gpt-4o'
    - `page_range` string

## Response `200`

Classifier created.

- Classifier
  - `classifier_id` string, uuid
  - `name` string
  - `user_id` string, uuid
  - `configs` ClassifierConfigs
    - `classes` ClassCategory[], required
      - `label` string, required
      - `description` string, required
    - `classifier_type` string
    - `query_model` 'gpt-4o-mini' | 'gpt-4o'
    - `page_range` string
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `400`: Malformed request or invalid arguments.
- `403`: API key does not have access to the requested resource, or a plan limit was hit.
- `500`: Something went wrong on DocumentPro's side.

---

[API](https://skmtc.dev/documentpro/apis/documentpro-api.md) · [All operations](https://skmtc.dev/documentpro/apis/documentpro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/documentpro/apis/documentpro-api/revisions/05d6bd485e28?raw)