/api/v1/support/issue/{externalId}/escalate

Escalates the ticket priority one step up the customer-facing ladder (low/normal → high → critical → blocker; blocker stays blocker) and appends a system audit comment naming the transition and the reporter's reason. Reason is validated by an LLM classifier before any write happens.

supportpostApiV1SupportIssueByExternalIdEscalate

Parameters

1 path · 1 query · JSON body

Path parameters

· 1

externalIdstringRequired

The 16-char alphanumeric external identifier of the issue.

Length: 16–16

Examplea1B2c3D4e5F6g7H8

Query parameters

· 1

apiKeystringRequired

Your BizKitHub API key (passed as GET parameter).

Key format: A 32-character string matching: ^(PROD|DEV_|ROOT)[A-Za-z0-9]{28}$
Prefixes: PROD (production key), DEV_ (individual developer), ROOT (system key with no limits). Learn more

ExamplePRODPGrFxpGEtrOZfuWhnoJohUYBXuOE

Request body

application/json

reasonstringRequired

Reporter's justification. Server rules: trim leading/trailing whitespace, silently truncate at 140 chars, reject as REASON_TOO_SHORT if fewer than 3 non-whitespace chars remain. Passed through an LLM classifier that rejects gibberish, spam, prompt-injection, and emphatic non-justifications ("urgent!!!", "asap") as INVALID_REASON.

Length: 1–500

ExampleProd down since 10 AM, cannot process orders.

Response schema

1 status code documented

200Success

object | object

One of 2:

Variant 1

success"true"Required

previousPrioritynumberRequired

Priority BEFORE the escalation (1..5).

newPrioritynumberRequired

Priority AFTER the escalation (1..5). Equal to previousPriority when already at blocker.

changedbooleanRequired

False when the ticket was already at blocker priority — the audit comment is still written.

Variant 2

success"false"Required

messagestringOptional

Human-readable explanation. Present on INVALID_REASON (short blurb from the classifier) and UPSTREAM_ERROR — surface verbatim in the UI.

Response example

application/json

{
  "success": true,
  "previousPriority": 0,
  "newPriority": 0,
  "changed": false
}

Request example

POST /api/v1/support/issue/{externalId}/escalate

post

curl -X POST "https://api.bizkithub.com/api/v1/support/issue/a1B2c3D4e5F6g7H8/escalate?apiKey=PRODPGrFxpGEtrOZfuWhnoJohUYBXuOE" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "reason": "Prod down since 10 AM, cannot process orders."
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key