BizKitHub
DocsAPI ReferenceSupport/api/v1/support/my-issue-reply
postSupportPublic API v1

/api/v1/support/my-issue-reply

Sends the reply as an e-mail to the reporter (same pipeline as an operator reply from admin) and stores it as an email_out comment. Author and e-mail signature are the caller (their organisation member when linked, otherwise the contact name), never the owner or the API-key owner. The e-mail is sent from the organisation sender address; the customer's answer returns into the ticket as usual. The status change is applied before the e-mail is rendered.

Checks in this order: 403 ISSUE_FORBIDDEN, 422 MESSAGE_TOO_SHORT / MESSAGE_TOO_LONG, 409 ISSUE_CLOSED, 409 ISSUE_CHANGED, 422 NO_REPORTER / EMAIL_DISABLED, 429 RATE_LIMITED (over 30 replies per hour per caller). Nothing is sent on any error.

Access rule ISSUE_ACCESS (evaluated on every call): the caller is the contact behind identityId in the organisation of apiKey. A ticket is accessible when it belongs to that organisation, is classified as not spam, and

  • A (assignment): it is assigned to the caller's contact (also confidential tickets), or
  • B (branch): its branch is an active branch the caller operates (shop__branch_person role technician, manager or owner), the ticket is not confidential (securedTicket / hidden from the branch) and it was not handed back to the head office.

There is no owner (root) shortcut and contact groups (fransiza, trainer, …) never grant access. An inaccessible and a non-existent externalId answer the same 403 ISSUE_FORBIDDEN. A missing or invalid identityId answers 401.

supportpostApiV1SupportMy-issue-reply

Parameters

2 query · JSON body

Query parameters

· 2
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
identityIdstringOptional

Logged user identity (from your frontend cookies). Learn more

ExampleZ9CPkS2o3UV163VQn5OUv0T8BQi8Fvdg

Request body

application/json
externalIdstringRequired

Opaque 16-char ticket id (externalId from /support/my-issue-list).

Length: 1–32
ExampleQr0MZ0vYnp8xMYgs
messagestringRequired

Plain-text reply, 10 to 8000 characters after trimming (MESSAGE_TOO_SHORT / MESSAGE_TOO_LONG).

Length: 0–20000
ExampleDobrý den, zámek jsme resetovali, už by měl fungovat.
targetStatus"done" | "waiting"Required

Status after the reply, mapped to the organisation default status of that category.

lastCommentIdstring | nullRequired

lastCommentId from the detail the caller saw (may be null). When somebody replied meanwhile, the call answers 409 ISSUE_CHANGED and nothing is sent.

One of 2:
Variant 1
string
Variant 2
null
customerRealIpstringOptional

User IP address used for GEO/IP intelligence.

Accepted formats:

  • IPv4 dot-decimal, e.g. 1.1.1.1 (4 octets, 0–255, no leading zeros).
  • IPv6 as defined by RFC 4291 — full 2001:0db8:0000:0000:0000:0000:0000:0001, zero-compressed 2001:db8::1, IPv4-mapped ::ffff:1.2.3.4, or scoped literals. Both upper- and lower-case hex are accepted.

Server-side canonicalization (ipNormalize in core/src/lib/network/ipNormalize.ts):

  • Valid IPv4 is passed through verbatim.
  • Valid IPv6 is lowercased (RFC 5952 §4.3).
  • IPv4-mapped IPv6 ::ffff:X.X.X.X is unwrapped to plain IPv4 (RFC 4291 §2.5.5.2) so 1.2.3.4 and ::ffff:1.2.3.4 share one brj__geo_ip row.
  • Loopback aliases (::1, 0.0.0.0, localhost, empty string) collapse to 127.0.0.1.
  • Junk values that fail both IPv4 and IPv6 validation are silently rejected and replaced with 127.0.0.1 (loopback).

On the wire: every response returns the canonicalized form — clients can safely rely on lowercase IPv6 and the plain-IPv4 unwrap when de-duping or joining. Server-originated writers (activity log, session log, ban list) resolve the visitor IP via resolveClientIp / resolveClientIpOrNull — always native IPv6 on Vercel Edge (there is no auto-mapping to ::ffff:X.X.X.X).

Enrichment: the system resolves reverse DNS, geolocation, ASN, mobile/proxy/hosting/Tor flags via our VikiTron GEO/IP resolver for both address families. Learn more

Examples1.1.1.12001:4860:4860::8888
attachmentsstring[]Optional

Optional files (multipart/form-data attachments parts). Same policy as /contact-form. Linked to the ticket.

Default: Files

Optional files (multipart/form-data attachments parts). Same policy as /contact-form. Linked to the ticket.

Response schema

5 status codes documented

200Success
success"true"Required
commentIdstringRequired
ExampleGYMRO-844_c1270
statusCategoryCode"new" | "progress" | "waiting" | "done"Required

Response example

application/json
{
  "success": true,
  "commentId": "GYMRO-844_c1270"
}

All documented status codes

· 5

Request example

POST /api/v1/support/my-issue-reply

post
curl -X POST "https://api.bizkithub.com/api/v1/support/my-issue-reply?apiKey=PRODPGrFxpGEtrOZfuWhnoJohUYBXuOE&identityId=Z9CPkS2o3UV163VQn5OUv0T8BQi8Fvdg" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "externalId": "Qr0MZ0vYnp8xMYgs",
  "message": "Dobrý den, zámek jsme resetovali, už by měl fungovat.",
  "customerRealIp": "1.1.1.1",
  "attachments": [
    "Files"
  ]
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key