Создать подразделение
Создает подразделение.
HTTP-запрос
POST https://api360.yandex.net/directory/v1/org/{orgId}/departments
Path-параметры
* Обязательный параметр
Тело запроса
{ "description": string, "externalId": string, "headId": string, "label": string, "name": string, "parentId": integer }
Скопировано
Представление
Поля
description | string Описание подразделения. |
externalId | string Произвольный внешний идентификатор подразделения. |
headId | string Идентификатор сотрудника-руководителя отдела. |
label | string Имя почтовой рассылки подразделения. Например, для адреса |
name * | string Название подразделения. |
parentId * | integer Идентификатор родительского подразделения. |
description | string Описание подразделения. |
externalId | string Произвольный внешний идентификатор подразделения. |
headId | string Идентификатор сотрудника-руководителя отдела. |
label | string Имя почтовой рассылки подразделения. Например, для адреса |
name * | string Название подразделения. |
parentId * | integer Идентификатор родительского подразделения. |
* Обязательный параметр
Ответы
Код 200
Запрос успешно выполнен.
{ "aliases": [ string ], "createdAt": string, "description": string, "email": string, "externalId": string, "headId": string, "id": integer, "label": string, "membersCount": integer, "name": string, "parentId": integer }
Скопировано
Представление
Поля
aliases[] | array Алиасы почтовых рассылок. |
createdAt | string Дата и время создания подразделения. |
description | string Описание подразделения. |
| string Адрес почтовой рассылки подразделения. |
externalId | string Произвольный внешний идентификатор подразделения. |
headId | string Руководитель подразделения. |
id | integer Идентификатор подразделения. |
label | string Имя почтовой рассылки подразделения. Например, для адреса |
membersCount | integer Количество сотрудников подразделения с учетом вложенных подразделений. |
name * | string Название подразделения. |
parentId * | integer Идентификатор родительского подразделения. |
aliases[] | array Алиасы почтовых рассылок. |
createdAt | string Дата и время создания подразделения. |
description | string Описание подразделения. |
| string Адрес почтовой рассылки подразделения. |
externalId | string Произвольный внешний идентификатор подразделения. |
headId | string Руководитель подразделения. |
id | integer Идентификатор подразделения. |
label | string Имя почтовой рассылки подразделения. Например, для адреса |
membersCount | integer Количество сотрудников подразделения с учетом вложенных подразделений. |
name * | string Название подразделения. |
parentId * | integer Идентификатор родительского подразделения. |
* Обязательный параметр
Код 401
Пользователь не авторизован.
{ "code": integer, "details": [ { "@type": string } ], "message": string }
Скопировано
Представление
Поля
code | integer |
details[] | array |
details[]. | string |
message | string |
code | integer |
details[] | array |
details[]. | string |
message | string |
* Обязательный параметр
Код 403
У пользователя или приложения нет прав на доступ к ресурсу, запрос отклонен.
{ "code": integer, "details": [ { "@type": string } ], "message": string }
Скопировано
Представление
Поля
code | integer |
details[] | array |
details[]. | string |
message | string |
code | integer |
details[] | array |
details[]. | string |
message | string |
* Обязательный параметр
Код 404
Запрашиваемый ресурс не найден.
{ "code": integer, "details": [ { "@type": string } ], "message": string }
Скопировано
Представление
Поля
code | integer |
details[] | array |
details[]. | string |
message | string |
code | integer |
details[] | array |
details[]. | string |
message | string |
* Обязательный параметр
Код 500
Внутренняя ошибка сервиса. Попробуйте повторно отправить запрос через некоторое время.
{ "code": integer, "details": [ { "@type": string } ], "message": string }
Скопировано
Представление
Поля
code | integer |
details[] | array |
details[]. | string |
message | string |
code | integer |
details[] | array |
details[]. | string |
message | string |
* Обязательный параметр