Создать общий ящик
Создает общий ящик в организации.
В ответе на запрос приходит поле resourceId — идентификатор созданного общего почтового ящика.
Примечание
Чтобы выполнить запрос, приложению требуется разрешение на управление правами доступа к почтовым ящикам. Убедитесь, что вы включили его при настройке приложения на OAuth-сервере Яндекса.
Request
PUT
https://api360.yandex.net/admin/v1/org/{orgId}/mailboxes/shared
Path parameters
|
Name |
Description |
|
orgId |
Type: integer Идентификатор организации. |
Body
application/json
{
"email": "example",
"name": "example",
"description": "example"
}
|
Name |
Description |
|
description |
Type: string Описание. Example: |
|
|
Type: string Адрес электронной почты общего ящика. Example: |
|
name |
Type: string Имя общего ящика. Example: |
Responses
200 OK
Запрос успешно выполнен.
Body
application/json
{
"resourceId": "example"
}
|
Name |
Description |
|
resourceId |
Type: string<uint64> Идентификатор почтового ящика. Example: |
400 Bad Request
Некорректный запрос.
Body
application/json
{
"code": 0,
"message": "example",
"details": [
{
"@type": "example"
}
]
}
|
Name |
Description |
|
code |
Type: integer Код ошибки. |
|
details |
Type: protobufAny[] Дополнительные сведения об ошибке. Example |
|
message |
Type: string Описание ошибки. Example: |
protobufAny
|
Name |
Description |
|
@type |
Type: string Example: |
|
[additional] |
Type: unknown Example: |
Example
{
"@type": "example"
}
401 Unauthorized
Пользователь не авторизован.
Body
application/json
{
"code": 0,
"message": "example",
"details": [
{
"@type": "example"
}
]
}
|
Name |
Description |
|
code |
Type: integer Код ошибки. |
|
details |
Type: protobufAny[] Дополнительные сведения об ошибке. Example |
|
message |
Type: string Описание ошибки. Example: |
403 Forbidden
У пользователя или приложения нет прав на доступ к ресурсу, запрос отклонен.
Body
application/json
{
"code": 0,
"message": "example",
"details": [
{
"@type": "example"
}
]
}
|
Name |
Description |
|
code |
Type: integer Код ошибки. |
|
details |
Type: protobufAny[] Дополнительные сведения об ошибке. Example |
|
message |
Type: string Описание ошибки. Example: |
404 Not Found
Запрашиваемый ресурс не найден.
Body
application/json
{
"code": 0,
"message": "example",
"details": [
{
"@type": "example"
}
]
}
|
Name |
Description |
|
code |
Type: integer Код ошибки. |
|
details |
Type: protobufAny[] Дополнительные сведения об ошибке. Example |
|
message |
Type: string Описание ошибки. Example: |
500 Internal Server Error
Внутренняя ошибка сервиса. Попробуйте повторно отправить запрос через некоторое время.
Body
application/json
{
"code": 0,
"message": "example",
"details": [
{
"@type": "example"
}
]
}
|
Name |
Description |
|
code |
Type: integer Код ошибки. |
|
details |
Type: protobufAny[] Дополнительные сведения об ошибке. Example |
|
message |
Type: string Описание ошибки. Example: |
No longer supported, please use an alternative and newer version.