Create new document group
POST
https://example.kaiten.ru/api/latest/document-groups| Name | Value |
|---|---|
| Content-Type | application/json |
| Name | Type | Constraints | Description |
|---|---|---|---|
title required | string | minLength: 1 maxLength: 256 | Document group title |
parent_entity_uid | string | null | Parent tree entity uid | |
for_everyone_access_role_id | string | null | Role id for everyone access | |
sort_order | number | minimum: 0 exclusiveMinimum: 0 | Sort order |
key | string | null | Unique document group key within company |
Responses
| Description | Response type | Example |
|---|---|---|
| Success | Object |
| Name | Type | Description |
|---|---|---|
| uid | string | Document group uid |
| id | integer | Document group id |
| title | string | Document group title |
| created | string | Create date |
| updated | string | Last update timestamp |
| archived | boolean | Document group archived flag |
| company_id | integer | Company id |
| author_id | integer | Author user id |
| parent_entity_uid | null | string | Parent tree entity uid |
parent_group_idDeprecated: use parent_entity_uid instead | null | string | Deprecated alias for parent_entity_uid |
| entity_type | string | Entity type. Always "document_group" |
| sort_order | number | Document group sort order |
| access | enum | Document group access type. "for_everyone" — accessible to all company members, "by_invite" — only invited members |
| for_everyone_access_role_id | null | string | Role id for everyone access |
| hostname | null | string | Custom hostname for public site |
| redirect_url | null | string | Redirect URL |
| key | null | string | Unique document group key within company |
| icon_type | null | string | Icon type. "material_icon" or null |
| icon_value | null | string | Icon value (icon name for material_icon type) |
| icon_color | null | integer | Icon color |
| public | boolean | Is document group publicly available (legacy field) |
| news_feed | boolean | Is document group marked as news feed |
| hidden_on_public_site | boolean | Document group is hidden on public site |
| path | string | Inner path to entity in tree |
| index_document_uid | null | string | UID of the document used as the home page for this folder |
| access_record | object | Current user access record to this document group |
| Description | Response type | Example |
|---|---|---|
| Validation error | Object |
| Name | Type | Description |
|---|---|---|
| message | string | Error message |
| Description | Response type | Example |
|---|---|---|
| Invalid token | String |
A schema has not been defined for this response code.
| Description | Response type | Example |
|---|---|---|
| Feature is not supported by tariff | Object |
| Name | Type | Description |
|---|---|---|
| message | string | Error message |
| Description | Response type | Example |
|---|---|---|
| Forbidden | Response body does not exist |
A schema has not been defined for this response code.
| Description | Response type | Example |
|---|---|---|
| Conflict — the key is already in use in the company | Object |
| Name | Type | Description |
|---|---|---|
| message | string | Error message |
| code | string | Error code |
Kaiten
If you have any questions or need help with integration feel free to write us at support@kaiten.io
1 curl --request POST \
2 --url 'https://example.kaiten.ru/api/latest/document-groups' \
3 --header 'Accept: application/json' \
4 --header 'Content-Type: application/json'
5 Response
ClickTry It!to start a request and see the response here!