Удалить сотрудника из Организации

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
👆 На этом пока всё