v1

latestOpenAPI 3.0.22026-07-17373198641.7 KB
document
v1

Create Document Type

Params:
    - code: str - Short name for field, max 50 symbols
    - title: str - Verbose name for field, max 100 symbols
    - field_code_aliases: json - Aliases of field codes for document import purposes
    - fields: array of objects like [{id: uid, category: id, order: int}, ...]
    - search_fields: array of uids - set of fields to filter/sort on Document list page
    - editor_type: str - max 100 symbols (from pre-defined choices)
    - metadata: json - optional
post/api/v1/document/document-types/

Request body

uidstring uuid
titlestring required
codestring required

Field codes must be lowercase, should start with a Latin letter, and contain only Latin letters, digits, and underscores.

managersinteger[]

Choose which users can modify this Document Type. Users chosen as Managers can be of any System-Level Permission.

search_fieldsstring[]
editor_type'save_by_field' | 'save_all_fields_at_once' required
field_code_aliasesobject nullable
metadataobject nullable
warning_messagestring

Example request

{
  "warning_message": "warning_message",
  "uid": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
  "metadata": "{}",
  "code": "code",
  "search_fields": [
    "search_fields",
    "search_fields"
  ],
  "field_code_aliases": "{}",
  "categories": [
    {
      "name": "name",
      "id": 5,
      "order": -1158723813
    },
    {
      "name": "name",
      "id": 5,
      "order": -1158723813
    }
  ],
  "title": "title",
  "fields": [
    {
      "code": "code",
      "id": "id",
      "category": 1,
      "title": "title",
      "order": 19536
    },
    {
      "code": "code",
      "id": "id",
      "category": 1,
      "title": "title",
      "order": 19536
    }
  ],
  "managers": [
    0,
    0
  ],
  "editor_type": "save_by_field"
}

Response

uidstring uuid
titlestring required
codestring required

Field codes must be lowercase, should start with a Latin letter, and contain only Latin letters, digits, and underscores.

managersinteger[]

Choose which users can modify this Document Type. Users chosen as Managers can be of any System-Level Permission.

search_fieldsstring[]
editor_type'save_by_field' | 'save_all_fields_at_once' required
field_code_aliasesobject nullable
metadataobject nullable
warning_messagestring

Example response

{
  "warning_message": "warning_message",
  "uid": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
  "metadata": "{}",
  "code": "code",
  "search_fields": [
    "search_fields",
    "search_fields"
  ],
  "field_code_aliases": "{}",
  "categories": [
    {
      "name": "name",
      "id": 5,
      "order": -1158723813
    },
    {
      "name": "name",
      "id": 5,
      "order": -1158723813
    }
  ],
  "title": "title",
  "fields": [
    {
      "code": "code",
      "id": "id",
      "category": 1,
      "title": "title",
      "order": 19536
    },
    {
      "code": "code",
      "id": "id",
      "category": 1,
      "title": "title",
      "order": 19536
    }
  ],
  "managers": [
    0,
    0
  ],
  "editor_type": "save_by_field"
}