AISARAISAR
REST API

Метки

Метки — простые именованные ярлыки компании (с опциональным цветом), которыми размечаются контакты и диалоги для последующей фильтрации, сегментации аудитории и запуска автоматизаций. Имя метки уникально в рамках компании. Привязка/отвязка метки к конкретному контакту или диалогу выполняется через соответствующие эндпоинты (`POST /contacts/{contact}/tags`, `POST /conversations/{conversation}/tags`), а этот раздел — CRUD самого справочника меток.

Эндпоинты

МетодПуть
GET/v1/tags

Список меток компании (с поиском по имени).

POST/v1/tags

Создать метку.

PATCH/v1/tags/{tag}

Обновить имя или цвет метки.

DELETE/v1/tags/{tag}

Удалить метку.

Примеры

Создание метки

Запрос

bash
curl -X POST "https://api.aisar.app/v1/tags" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "vip",
    "color": "#22c55e"
  }'

Ответ

json
{
  "data": {
    "message": "Tag created.",
    "tag": {
      "id": 7,
      "company_id": 1,
      "name": "vip",
      "color": "#22c55e",
      "created_at": "2026-02-09T18:00:00Z",
      "updated_at": "2026-02-09T18:00:00Z"
    }
  }
}

Список меток

Запрос

bash
curl -X GET "https://api.aisar.app/v1/tags?search=vip" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Ответ

json
{
  "data": [
    {
      "id": 7,
      "company_id": 1,
      "name": "vip",
      "color": "#22c55e",
      "created_at": "2026-02-09T18:00:00Z",
      "updated_at": "2026-02-09T18:00:00Z"
    }
  ]
}