Изменить права доступа

  1. HTTP-запрос
  2. Path-параметры
  3. Query-параметры
  4. Тело запроса
    1. Представление
    2. Поля
  5. Ответы
    1. Код 200
      1. Представление
      2. Поля
    2. Код 401
      1. Представление
      2. Поля
    3. Код 403
      1. Представление
      2. Поля
    4. Код 404
      1. Представление
      2. Поля
    5. Код 500
      1. Представление
      2. Поля

Предоставляет или изменяет права доступа сотрудника к чужому почтовому ящику.

Действие асинхронное: можно отправлять следующий запрос, не дожидаясь выполнения предыдущего.
Возвращает идентификатор задачи, по которому можно проверить состояние ее выполнения.

Ограничение. Чтобы выполнить запрос, приложению требуется разрешение на управление правами доступа к почтовым ящикам. Убедитесь, что вы включили его при настройке приложения на OAuth-сервере Яндекса.

HTTP-запрос

POST https://api360.yandex.net/admin/v1/org/{orgId}/mail/delegated\
?resourceId={string}\
&actorId={string}

Path-параметры

orgId *

integer

Идентификатор организации.

orgId *

integer

Идентификатор организации.

Query-параметры

resourceId *

string

Идентификатор владельца почтового ящика, права доступа к которому необходимо предоставить или изменить.

actorId *

string

Идентификатор сотрудника, для которого настраивается доступ.

resourceId *

string

Идентификатор владельца почтового ящика, права доступа к которому необходимо предоставить или изменить.

actorId *

string

Идентификатор сотрудника, для которого настраивается доступ.

Тело запроса

{
  "rights": [
    "string"
  ]
}
Скопировано

Представление

Свернуть всё
Развернуть всё

Поля

rights[] *

array

Список прав доступа.
Возможные значения:

  • imap_full_access — право на чтение почты и управление настройками ящика по протоколу IMAP, возможности отправлять письма это право не дает.
  • send_on_behalf — возможность отправлять письма из ящика по протоколу SMTP от своего имени: в поле "От кого" в письме будет указан адрес настоящего отправителя.
  • send_as — возможность отправлять письма по протоколу SMTP от имени владельца ящика: в поле "От кого" в письме будет указан адрес владелеца.

rights[] *

array

Список прав доступа.
Возможные значения:

  • imap_full_access — право на чтение почты и управление настройками ящика по протоколу IMAP, возможности отправлять письма это право не дает.
  • send_on_behalf — возможность отправлять письма из ящика по протоколу SMTP от своего имени: в поле "От кого" в письме будет указан адрес настоящего отправителя.
  • send_as — возможность отправлять письма по протоколу SMTP от имени владельца ящика: в поле "От кого" в письме будет указан адрес владелеца.

Ответы

Код 200

Запрос успешно выполнен.

{
  "taskId": string
}
Скопировано

Представление

Свернуть всё
Развернуть всё

Поля

taskId *

string

Идентификатор задачи на управление правами доступа.

taskId *

string

Идентификатор задачи на управление правами доступа.

Код 401

Пользователь не авторизован.

{
  "code": integer,
  "details": [
    {
      "@type": string
    }
  ],
  "message": string
}
Скопировано

Представление

Свернуть всё
Развернуть всё

Поля

code

integer

details[]

array

details[].@type

string

message

string

code

integer

details[]

array

details[].@type

string

message

string

Код 403

У пользователя или приложения нет прав на доступ к ресурсу, запрос отклонен.

{
  "code": integer,
  "details": [
    {
      "@type": string
    }
  ],
  "message": string
}
Скопировано

Представление

Свернуть всё
Развернуть всё

Поля

code

integer

details[]

array

details[].@type

string

message

string

code

integer

details[]

array

details[].@type

string

message

string

Код 404

Запрашиваемый ресурс не найден.

{
  "code": integer,
  "details": [
    {
      "@type": string
    }
  ],
  "message": string
}
Скопировано

Представление

Свернуть всё
Развернуть всё

Поля

code

integer

details[]

array

details[].@type

string

message

string

code

integer

details[]

array

details[].@type

string

message

string

Код 500

Внутренняя ошибка сервиса. Попробуйте повторно отправить запрос через некоторое время.

{
  "code": integer,
  "details": [
    {
      "@type": string
    }
  ],
  "message": string
}
Скопировано

Представление

Свернуть всё
Развернуть всё

Поля

code

integer

details[]

array

details[].@type

string

message

string

code

integer

details[]

array

details[].@type

string

message

string