Docs
Консоль

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

POST
/api/v1/trackers

Авторизация

oauth2 tracker:create
headerAuthorizationBearer <token>

Scope: tracker:create

Тело запроса

application/json
  1. body

Состав тела зависит от payloadType: для text обязателен rowTemplate, а columns передавать нельзя; для csv, xlsx и json обязателен непустой columns, а rowTemplate передавать нельзя. Лишнее поле отвергается с 400 «This form should not contain extra fields».

name*string

Название трекера

description?string

Описание

isActive?boolean

Включен ли трекер

metric*string

Идентификатор метрики

Форматuuid
payloadType?string

Формат отправляемых данных, значения из GET /api/v1/trackers/payloadTypes. По умолчанию text

По умолчанию"text"
Одно из"text""csv""xlsx""json"
rowTemplate?string

Шаблон строки для формата text, в фигурных скобках поля строки метрики из GET /api/v1/metrics/types/{type}/columns

columns?array<string>

Колонки результата метрики для форматов csv, xlsx и json, значения из GET /api/v1/metrics/types/{type}/columns

Элементов1 <= items
scheduler*
connectors*array<>
Элементов1 <= items

Тело ответа

application/json
  1. response
data?
Пример запроса
curl -X POST 'https://example.com/api/v1/trackers' \  -H 'Content-Type: application/json' \  -d '{  "name": "Критичные уязвимости в Jira",  "metric": "1f012642-c266-608a-b68a-b16c5dc585d3",  "scheduler": {    "intervalIso": "P1D"  },  "connectors": [    {      "connector": "1f0f5ec0-4e62-6af2-b702-a904e694f5b1",      "config": {}    }  ]}'
Пример ответа
{  "data": {    "id": "1f0da6ba-d3f4-6428-b120-03f29d7ef45b",    "name": "Критичные уязвимости в Jira",    "isActive": true,    "metric": {      "id": "1f00b183-485d-6c4a-a451-7794ea12f5fa",      "name": "total_vuln",      "labels": {        "env": "prod"      },      "isTracked": false,      "creator": {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "name": "string"      },      "editor": {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "name": "string"      },      "createdAt": "2025-03-27T14:31:43+00:00",      "updatedAt": "2025-03-27T14:31:43+00:00",      "type": "device",      "aggrType": "sum",      "description": ""    },    "creator": {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string"    },    "editor": {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string"    },    "createdAt": "2025-12-16T10:40:45+00:00",    "updatedAt": "2025-12-16T10:45:41+00:00",    "scheduler": {      "intervalIso": {        "label": "Once a day",        "value": "P1D"      },      "lastRunAt": "2026-10-19T20:13:01+00:00",      "nextRunAt": "2026-10-19T20:23:06+00:00",      "errors": [        {          "id": "1f1961d6-0249-6ac6-a2aa-6b58ee6e80d8",          "title": "Jira cloud",          "error": "Jira cloud API error: Not Found"        }      ]    },    "payloadType": {      "label": "CSV",      "value": "csv"    },    "description": "",    "rowTemplate": "Title: {{ row.title }} | Status: {{ row.status }}",    "columns": [      "title",      "status"    ],    "connectors": [      {        "id": "1f0da6ba-d3f6-6e6c-8c0a-03f29d7ef45b",        "connector": {          "id": "1f0d6885-35bb-6c8e-a6bd-1123a78b2b28",          "name": "Jira server",          "type": "jiraServer",          "isActive": true,          "createdAt": "2025-12-11T11:55:45+00:00",          "updatedAt": "2026-01-19T08:12:42+00:00",          "creator": {            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",            "name": "string"          }        },        "config": {          "projectId": "10000",          "issueTypeId": "10100",          "closeStatusId": "10000",          "assignee": "admin",          "priorityId": null,          "dueDays": 10,          "parentId": null,          "labels": [            "security"          ],          "customFields": [            {              "id": "customfield_10172",              "name": "paragraph field",              "value": "text"            }          ],          "to": [            "security@example.com"          ],          "chatId": "-1001234567890"        },        "createdAt": "2025-12-16T10:40:45+00:00",        "updatedAt": "2026-10-19T20:24:00+00:00"      }    ]  }}