API: tickets

Статус: GA Доступ: по токену контракт API: 0.3.0 · capability 2026-09-03.1 Открыть как Markdown Открыть в Claude Открыть в ChatGPT

`GET /api/v1/tickets`

List Board

Открыть отдельной страницей →

The owner board — defects/incidents by default, or a vote-ranked suggestion backlog with ?kind=suggestion. Team-readable (owner + team, the defect section of the tasks board; agents still get 403.

Авторизация: нужен Authorization: Bearer <token>

Параметр	Где	Обязателен	Тип	Описание
`kind`	query	нет	`string \| null`	defect\|incident\|suggestion (default: the defect/incident board)
`status`	query	нет	`string \| null`	open\|closed
`component`	query	нет	`string \| null`
`area`	query	нет	`string \| null`	platform\|pipelines\|instances\|other
`severity`	query	нет	`string \| null`
`since`	query	нет	`string \| null`	tickets created at/after this UTC time
`limit`	query	нет	`integer`

Ответы:

Код	Смысл	Тело
`200`	Successful Response	`массив TicketRead`
`401`	Missing or invalid authentication credentials	`ErrorResponse`
`422`	Validation Error	`HTTPValidationError`

`POST /api/v1/tickets`

File Ticket

Открыть отдельной страницей →

Intake one report; return a bare 202.

Write-only fire-and-forget: no ticket id, no dedup verdict — a hostile or looping reporter gets nothing back to react to. Over the flood cap → 429; an oversized body → 413.

Авторизация: нужен Authorization: Bearer <token>

Параметр	Где	Обязателен	Тип	Описание
`Idempotency-Key`	header	нет	`string`	Optional.

Тело запроса: application/json — схема TicketReportIn

Поле	Тип	Обязательно
`actual`	`string \| null`	нет
`alternatives`	`массив string \| null`	нет
`area`	`string \| null`	нет
`behavior_cases`	`массив string \| null`	нет
`body`	`string \| null`	нет
`component`	`string \| null`	нет
`contract_guid`	`integer \| null`	нет
`environment`	`object \| null`	нет
`evidence`	`массив EvidenceItem \| null`	нет
`expected`	`string \| null`	нет
`expected_benefit`	`string \| null`	нет
`fingerprint`	`string \| null`	нет
`kind`	`string \| null`	нет
`payload`	`object \| null`	нет
`problem`	`string \| null`	нет
`proposed_change`	`string \| null`	нет
`run_guid`	`integer \| null`	нет
`severity`	`string \| null`	нет
`spec_ref`	`string \| null`	нет
`steps_to_reproduce`	`массив string \| null`	нет
`title`	`string`	да

Пример:

{
  "actual": "The Description column is empty",
  "component": "portal",
  "environment": {
    "commit": "dcaf59d1"
  },
  "evidence": [
    {
      "type": "url",
      "url": "https://enterium-developer-docs.pages.dev/developers/mcp/tools/entherium_create_task/"
    }
  ],
  "expected": "Every parameter has a description",
  "kind": "defect",
  "severity": "sev3",
  "steps_to_reproduce": [
    "Open /developers/mcp/tools/entherium_create_task/",
    "Look at the Parameters table"
  ],
  "title": "Tool page renders an empty Description column"
}

Ответы:

Код	Смысл	Тело
`202`	Successful Response	`object`
`401`	Missing or invalid authentication credentials	`ErrorResponse`
`422`	Validation Error	`HTTPValidationError`

`PATCH /api/v1/tickets/{guid}`

Transition Ticket

Открыть отдельной страницей →

Resolve / dismiss / promote a ticket, state-machine-guarded.

Owner-only. An illegal transition (e.g. closing an already-closed ticket) → 409.

Авторизация: нужен Authorization: Bearer <token>

Параметр	Где	Обязателен	Тип	Описание
`guid`	path	да	`integer`
`Idempotency-Key`	header	нет	`string`	Optional.

Тело запроса: application/json — схема TicketPatch

Поле	Тип	Обязательно
`action`	`"resolve" \| "dismiss" \| "promote" \| "target" \| "reopen" \| "edit"`	да
`description`	`string \| null`	нет
`promoted_to`	`string \| null`	нет
`resolution`	`string \| null`	нет
`severity`	`"sev1" \| "sev2" \| "sev3" \| "sev4" \| null`	нет
`spec_ref`	`string \| null`	нет
`title`	`string \| null`	нет

Пример:

{
  "action": "resolve",
  "resolution": "fixed in build 0.3.1; verified on the live URL"
}

Ответы:

Код	Смысл	Тело
`200`	Successful Response	`TicketRead`
`401`	Missing or invalid authentication credentials	`ErrorResponse`
`422`	Validation Error	`HTTPValidationError`