Создать новый список персон

POST /person/list/create

Описание

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

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

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

Авторизация

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

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

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

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

ПолеТипОбязательныйОписание
tokenstring—Постоянный API-токен (UUID), если нет заголовка token
namestring✅Название нового списка
list_idstring❌Идентификатор списка (опционально)

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

curl -X POST "https://api.neuro-vision.ru/v1/person/list/create" -H "Content-Type: application/json" -H "token: <jwt-token>" -d '{"name": "Colleagues", "list_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"}'

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

Успех (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 does not found",
  "status": "error"
}