Тікети

Create tickets, read their status and add comments (REST API v1).

Створити тікет

POST /api/v1/tickets

Creates a ticket in the tenant bound to the API key. Send an Idempotency-Key header so retries don’t create duplicates: a repeated key returns the original result with action: deduplicated.

Автентифікація: Ключ API: Authorization: Bearer nhk.<keyid>.<secret>, або ключ API в X-NH-API-Key

Параметри

Назва	Де	Тип	Обов’язковий	Опис
`Idempotency-Key`	заголовок	string	ні	Unique key per logical operation (UUID recommended). A retry with the same key returns the first result.

Тіло запиту

application/json

Назва	Тип	Обов’язковий	Опис
`subject`	string	ні	Ticket title. Required (alias: `summary`).
`summary`	string	ні	застаріле Alias of `subject`.
`description`	string	ні	Body text (alias: `body`).
`priority`	string	ні	Priority name. The tenant’s priority scheme may define more values.
`category`	string	ні	Category hint used by routing.
`issuetype`	string	ні	Issue-type override, for example `IT-INC` or `IT-SR`.
`country`	string	ні	ISO 3166-1 alpha-2 country, if your tenant routes by country.
`sender_email`	string (email)	ні	Requester. Defaults to the key’s contact.
`sender_name`	string	ні
`sender_phone`	string	ні
`company`	string	ні
`external_id`	string	ні	Your system’s id, kept for correlation.
`tags`	array<string>	ні
`attachments`	array<object>	ні	Attachments by reference (URL). Binary upload is not part of v1.
`attachments[].name`	string	так
`attachments[].url`	string (uri)	ні
`attachments[].size`	integer	ні
`attachments[].mime`	string	ні

{
  "subject": "Payment gateway returns HTTP 502",
  "description": "Checkout fails for all EU customers since 09:12 UTC.",
  "priority": "High",
  "category": "Application",
  "sender_email": "[email protected]",
  "sender_name": "ACME On-call",
  "external_id": "INC-88231",
  "tags": [
    "checkout",
    "eu-west"
  ]
}

Відповіді

Статус	Опис
`200`	Ticket created (or deduplicated by `Idempotency-Key`).
`400`	Invalid request.
`401`	API key missing, invalid or revoked.
`403`	Key disabled or missing the required scope.
`429`	Rate limit exceeded for this API key.
`500`	Unexpected server error. Retry with the same `Idempotency-Key`.

Приклад 200

{
  "ok": true,
  "ticket_key": "ACME-1042",
  "ingestion_id": "ing_7f3c2a91",
  "action": "created",
  "status_url": "/api/v1/tickets/ACME-1042",
  "skipped": null,
  "backend_status": null,
  "backend_error": null,
  "error": null,
  "post_routing": null
}

Приклад із curl

curl -X POST "https://exocortex-api.ai-exo-cortex.com/api/v1/tickets" \
  -H "Authorization: Bearer $EXO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  --data '{"subject":"Payment gateway returns HTTP 502","description":"Checkout fails for all EU customers since 09:12 UTC.","priority":"High","category":"Application","sender_email":"[email protected]","sender_name":"ACME On-call","external_id":"INC-88231","tags":["checkout","eu-west"]}'

Отримати тікет

GET /api/v1/tickets/{key}

Returns the current status of a ticket in the API key’s tenant. Tickets of other tenants return 404.

Автентифікація: Ключ API: Authorization: Bearer nhk.<keyid>.<secret>, або ключ API в X-NH-API-Key

Параметри

Назва	Де	Тип	Обов’язковий	Опис
`key`	шлях	string	так	Ticket key.

Відповіді

Статус	Опис
`200`	Ticket found.
`401`	API key missing, invalid or revoked.
`403`	Key disabled or missing the required scope.
`404`	Ticket not found in the API key’s tenant.
`429`	Rate limit exceeded for this API key.
`500`	Unexpected server error. Retry with the same `Idempotency-Key`.

Приклад 200

{
  "ok": true,
  "ticket": {
    "key": "ACME-1042",
    "summary": "Payment gateway returns HTTP 502",
    "status": "In Progress",
    "priority": "High",
    "assignee": "Jane Doe",
    "created": "2026-11-01T09:14:05.000Z",
    "updated": "2026-11-01T09:31:47.000Z"
  }
}

Приклад із curl

curl -X GET "https://exocortex-api.ai-exo-cortex.com/api/v1/tickets/ACME-1042" \
  -H "Authorization: Bearer $EXO_API_KEY"

Додати коментар

POST /api/v1/tickets/{key}/comment

Автентифікація: Ключ API: Authorization: Bearer nhk.<keyid>.<secret>, або ключ API в X-NH-API-Key

Параметри

Назва	Де	Тип	Обов’язковий	Опис
`key`	шлях	string	так	Ticket key.
`Idempotency-Key`	заголовок	string	ні	Unique key per logical operation (UUID recommended). A retry with the same key returns the first result.

Тіло запиту

application/json

Назва	Тип	Обов’язковий	Опис
`comment`	string	ні	Comment text. Required (alias: `text`).
`text`	string	ні	застаріле Alias of `comment`.
`sender_email`	string (email)	ні
`sender_name`	string	ні

{
  "comment": "Rollback of release 4.18.2 completed; error rate back to baseline.",
  "sender_email": "[email protected]"
}

Відповіді

Статус	Опис
`200`	Comment accepted.
`400`	Invalid request.
`401`	API key missing, invalid or revoked.
`403`	Key disabled or missing the required scope.
`404`	Ticket not found in the API key’s tenant.
`429`	Rate limit exceeded for this API key.
`500`	Unexpected server error. Retry with the same `Idempotency-Key`.

Приклад 200

{
  "ok": true,
  "ticket_key": "ACME-1042",
  "ingestion_id": "ing_91be04d2"
}

Приклад із curl

curl -X POST "https://exocortex-api.ai-exo-cortex.com/api/v1/tickets/ACME-1042/comment" \
  -H "Authorization: Bearer $EXO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  --data '{"comment":"Rollback of release 4.18.2 completed; error rate back to baseline.","sender_email":"[email protected]"}'

Сторінку згенеровано зі специфікації OpenAPI API інтеграції, версія 1.1.0.