Обновить персону в списке

POST /person/update

Описание

Метод обновляет данные персоны в указанном или дефолтном списке. Для доступа нужен токен, см. раздел «Авторизация».

Формат запроса

HTTP метод: POST
URL: /person/update
Тип контента: application/json

Авторизация

Токен передаётся одним из способов:

заголовок token: <jwt-token> — временный JWT-токен, полученный методом user/login;
поле token в теле запроса — постоянный API-токен (UUID) из личного кабинета.

Без токена запрос вернёт 401 access denied.

Тело запроса (JSON)

Поле	Тип	Обязательный	Описание
token	string	—	Постоянный API-токен (UUID), если нет заголовка `token`
list_id	string	✅	Идентификатор списка персон
person_id	string	✅	Идентификатор персоны
fields	string[]	❌	Новый массив строк с бизнес-данными
drop_image	boolean	❌	Не сохранять изображение в истории
new_list_id	string	❌	Идентификатор нового списка для перемещения

Пример запроса (cURL)

curl -X POST "https://api.neuro-vision.ru/v1/person/update" -H "Content-Type: application/json" -H "token: <jwt-token>" -d '{"list_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "person_id": "75e55780-8943-11ea-9773-e96daa282099", "fields": ["New Name", "New Info"], "drop_image": true, "new_list_id": "e564e890-893b-11ea-8772-3b4b123daaaa"}'

Примеры ответов

Успех (200 OK)

{
  "status": "ok"
}

Ошибка (400 Bad Request)

{
  "message": "invalid schema",
  "status": "error"
}

Ошибка (401 Unauthorized)

{
  "message": "access denied",
  "status": "error"
}

Ошибка (404 Not Found)

{
  "message": "item with this id not found",
  "status": "error"
}