Create ticket
POST/v1/tickets
Legt im aktuellen Tenant ein neues Ticket an. Die Sequenznummer
(z. B. T-2026-00042) wird vom Server vergeben und kann nicht
überschrieben werden. Ein Audit-Eintrag (JSON-Patch) wird in derselben
Transaktion geschrieben.
Wenn assigneeId übergeben wird, prüft die API, dass die Person zum
selben Tenant gehört — sonst antwortet sie mit 422. Wird keine SLA-
Policy angegeben, wird die Standard-Policy aus dem Vertrag der Partei
angewendet.
Datenmodell
Diese Operation arbeitet auf der Entität Ticket (ticket). Alle 80 Felder — Typ, Validierung, Pflichtangabe, Beziehungen — stehen in der Schema-Referenz.
- Pflichtfelder:
title,status,priority - Server-verwaltet:
_id,schema,schemaVersion,tenantId,version,createdAt,updatedAt,createdBy,updatedBy,deletedAt,deletedBy,ticketNumber,dispatch,aiSummary,aiSummaryAttemptedAt,budget.consumedMinutes,budget.locked,budget.lockedAt,budget.lockedReason,budget.unlockRequestId,budget.capHistory,salesOrderId,salesOrderItemId,salesOrderItemSource,standaloneBilling.enabledBy,standaloneBilling.enabledAt,standaloneBilling.performanceRecordId,standaloneBilling.performanceRecordNumber,standaloneBilling.invoicedAt,handlingTier,handedToCustomerAt,slaPausedMs,handoverPreviousAssigneeId,convertedTo,convertedFrom,aiReopenSuggestion,aiReopenDecision,aiReopenConfidence,aiReopenBasis,aiReopenConfirmedBy,externalOwnership,externalOwnershipTakenAt,externalOwnershipTakenBy,externalOwnershipTag— diese Felder vergibt die Plattform; im Request werden sie verworfen.
Beispiel
curl -X POST https://api.codemeta-os.de/v1/tickets \
-H "X-Tenant-Id: $TENANT" \
-H "Content-Type: application/json" \
-b cookies.txt \
-d '{
"title": "Drucker im OG2 wirft Fehler 0xC4",
"partyId": "{{sandbox.partyId}}",
"priority": "high"
}'const result = await cm.tickets.post({
"title": "Drucker im OG2 wirft Fehler 0xC4",
"partyId": "{{sandbox.partyId}}",
"priority": "high"
});Best Practice
Nutzen Sie Idempotency-Key (UUIDv4), wenn Sie Tickets aus einem
anderen System spiegeln (E-Mail-Webhook, weclapp-Order, Asset-Alarm).
Eine zweite Anfrage mit demselben Key gibt das ursprüngliche Ticket
zurück, ohne ein neues anzulegen.
Antwortcodes
| HTTP | Bedeutung |
|---|---|
200 |
Default Response |