---
title: "POST /api/v1/document/document-field-categories/"
method: POST
path: "/api/v1/document/document-field-categories/"
tags: ["document", "v1"]
---

# POST /api/v1/document/document-field-categories/

`POST /api/v1/document/document-field-categories/`

Create DocumentFieldCategory

    Params:
        - document_type: uid
        - name: str - Verbose name for field category, max 100 symbols
        - order: int
        - fields: array of field uids

## Request body

- DocumentFieldCategoryCreate
  - `id` integer
  - `document_type` string, nullable, required
  - `name` string, required
  - `order` integer, required
  - `fields` string[], nullable
  - `fields_number` integer

## Response `201`

- DocumentFieldCategoryCreate
  - `id` integer
  - `document_type` string, nullable, required
  - `name` string, required
  - `order` integer, required
  - `fields` string[], nullable
  - `fields_number` integer

## Changes

- **2021-05-24** `8167164be9cc` — 3 breaking, 5 info
  - the `fields/items/` request property type/format changed from ``/`` to `string`/`` (media type: application/json)
  - the response property `fields` became nullable for the status `201`
  - the `fields/items/` response's property type/format changed from ``/`` to `string`/`` for status `201`
  - the request property `fields` became nullable (media type: application/json)
  - …4 more
- **2020-12-11** `0957c4a7ae3d` — 5 breaking, 2 info
  - the request property `fields` became not nullable (media type: application/json)
  - the request property `fields` became not nullable (media type: application/x-www-form-urlencoded)
  - the request property `fields` became not nullable (media type: multipart/form-data)
  - the `fields/items/` request property type/format changed from `string`/`` to ``/`` (media type: application/json)
  - …3 more

[Change history](https://skmtc.dev/lexpredict/apis/contraxsuite-api/changes/api/v1/document/document-field-categories/post.md)

---

[API](https://skmtc.dev/lexpredict/apis/contraxsuite-api.md) · [All operations](https://skmtc.dev/lexpredict/apis/contraxsuite-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lexpredict/contraxsuite-api/revisions/3429f921b4cb/schema)