Исключение сотрудника из Организации

POST /membership/{membershipId}/delete

В разделе описан запрос исключения сотрудника из организации.

Получить идентификаторы сотрудников можно с помощью запроса, в параметре "membershipId".


МЕТОД HTTP

POST


URL

https://userapi.mts-link.ru/v3/membership/{membershipId}/delete


ОБЯЗАТЕЛЬНЫЕ ПАРАМЕТРЫ

  • membershipId — идентификатор исключаемого сотрудника из организации


ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ

По умолчанию данные исключаемого сотрудника остаются ему в личном кабинете. Если необходимо исключить сотрудника и при этом передать его данные кому-нибудь другому в организации, то потребуется указать параметр:

  • destinationMembershipId — идентификатор сотрудника, которому переносятся данные от исключаемого.


СОСТОЯНИЯ ОТВЕТОВ:


204 No Content

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

400 Bad Request

  • "message": "Can not normalize the option \"destinationMembershipId\" with value \"\" into \"int\"" — destinationMembershipId не соответствует формату идентификаторов;

  • "message": "Organization destination membership not found" — Сотрудника с указанным destinationMembershipId нет в организации.

401 Unauthorized

  • Ключ userapi не передан, или является недействительным.

403 Forbidden

  • "message": "No userapi access" — В тарифе нет возможности работы с userapi;

  • "message": "A user with the \"STUDENT\" type is not supported" — Текущий тип пользователя не поддерживается.

404 Not Found

  • "message": "Organization membership not found" — исключаемого сотрудника (membershipId) в организации не найдено.


ПРИМЕР ЗАПРОСА

url: https://userapi.mts-link.ru/v3/membership/11111111/delete,
method: POST,
headers: 
{
    x-auth-token: {Token},
    Content-Type: application/x-www-form-urlencoded
};
body:
{
    destinationMembershipId: 000000,
};

ПРИМЕР ОТВЕТА

204 No Content
👆 На этом пока всё