Create a new list of persons

POST /person/list/create

Description

The method creates a new list of user persons. A token is required, see Authorization.

Request format

  • HTTP method: POST
  • URL: /person/list/create
  • Content type: application/json

Authorization

Pass the token in one of two ways:

  • the token: <jwt-token> header — a temporary JWT token obtained with user/login;
  • the token field in the request body — a permanent API token (UUID) from your account.

Without a token the request returns 401 access denied.

Request Body (JSON)

FieldTypeRequiredDescription
tokenstring—Permanent API token (UUID), if the token header is not sent
namestring✅Name of the new list
list_idstring❌List identifier (optional)

Example Request (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"}'

Example Answers

Success (200 OK)

{
  "status": "ok"
}

Error (400 Bad Request)

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

Error (401 Unauthorized)

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

Error (404 Not Found)

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