Публичный APIПользователи5. DELETE /user/emails — удалить один или несколько email-адресов

5. DELETE /user/emails — удалить email-адреса

Описание

Удаляет один или несколько email-адресов из аккаунта авторизованного пользователя.
Удаление основного email-адреса невозможно, если в аккаунте не останется хотя бы одного подтвержденного адреса.

⚠️ Требуется действительный токен авторизации с правами на управление профилем.

Параметры URL

Данный метод не содержит параметров пути.

Параметры запроса

Данный метод не принимает параметров в строке запроса.

Тело запроса

Тело запроса обязательно и должно быть в формате JSON.

ПолеТипОбязательныйОписание
emailsarrayДаСписок email-адресов для удаления

💡 Максимальное количество адресов за один запрос — 10.

Пример запроса

curl -X DELETE "https://api.gitverse.ru/user/emails" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/vnd.gitverse.object+json;version=1" \
  -d '{
    "emails": [
      "alice.backup@example.com"
    ]
  }'

Ответ (204 No Content)

HTTP/1.1 204 No Content

💡 Тело ответа отсутствует. Код 204 означает, что указанные email-адреса успешно удалены.

Коды ответа

КодСтатусОписание
204No ContentEmail-адреса успешно удалены
400Bad RequestНекорректный формат тела запроса
401UnauthorizedТокен отсутствует или недействителен
403ForbiddenДоступ запрещен
404Not FoundОдин или несколько email-адресов не найдены в аккаунте
422Unprocessable EntityПопытка удалить единственный подтвержденный email-адрес
500Internal Server ErrorВнутренняя ошибка сервера