support

POST `/v1/tickets/deflect`

Knowledge-base articles and a live diagnosis, before a ticket is opened.

Authentifizierung

Senden Sie einen API-Schlüssel als Bearer-Token. Der Schlüssel muss über die Berechtigung tickets.reply verfügen; ein Schlüssel ohne diese wird mit 403 statt 404 abgelehnt.

Hier kommt Ihre Organisations-ID hin

Dieser Endpunkt akzeptiert org_id als Feld im JSON-Body.

Die ID Ihrer Organisation finden Sie im Dashboard auf dem Bildschirm für API-Schlüssel direkt neben dem Schlüssel selbst. Sie ist bei jedem Ihrer Aufrufe dieselbe.

Ausprobieren

Ersetzen Sie alles in spitzen Klammern durch Ihre eigenen Werte und den Platzhalter für den Schlüssel durch einen Schlüssel aus Ihrem Dashboard.

curl -X POST https://api.zinndigital.com/v1/tickets/deflect \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{  }'

Angemeldet? Die API-Konsole in Ihrem Dashboard trägt automatisch Ihre echte Organisations-ID sowie Ihren eigenen Schlüssel ein und führt die Anfrage gegen die Live-API aus, sodass Sie die tatsächliche Antwort sehen können. Öffnen Sie diesen Endpunkt in der API-Konsole

Details

The KB + AI in front of the ticket form (#2661). Given what the customer has typed so far, returns matching published KB articles and — when a site is named — findings from live checks against it, including whether its nameservers still point at us. ⛔ This never refuses to open a ticket and must never be made to. Everything it returns is offered; the form's submit button is unaffected. Requires `tickets.reply`. ⛔ `checks_incomplete` is `true` when a check could not run. "We found nothing wrong" and "we could not look" are different answers and the client must render them differently.

Anfragekörper

Name	Typ	Erforderlich	Was es ist
`subject`	`string`	Nein	—
`body`	`string`	Nein	—
`site_id`	`object`	Nein	The site they are asking about. When given, live checks run against it — including whether its nameservers still point at us.
`org_id`	`object`	Nein	—

Antwort

Name	Typ	Erforderlich	Was es ist
`articles`	`object[]`	Ja	—
`findings`	`TicketDeflectionFinding[]`	Ja	—
`applied`	`string[]`	Ja	Remedies applied automatically. ⛔ Only remedies on an explicit, audited allow-list are ever applied without a human.
`checks_incomplete`	`boolean`	Ja	⛔ True when a live check could not run. "We found nothing wrong" and "we could not look" are different answers and must render differently.
`incidents`	`TicketDeflectionIncident[]`	Ja	Open public incidents affecting this customer. ⛔ NOTHING HERE BLOCKS THE FORM — owner ruling 2026-08-24 was warn prominently, still let them submit. A customer with a genuinel…
`status_url`	`string`	Ja	The public status page in the reader's language, for the "follow this to resolution" link. ⛔ A separate origin with no shared fate with the platform (docs/121 §1), so it cannot…

Fehler, die dieser Endpunkt zurückgeben kann

401 · 403 · 422 · 429