List tickets

Listet Tickets im aktuellen Tenant. Standardmäßig sind gesoftdeletete Einträge ausgeblendet. Filter nach status, priority, assigneeId und partyId können kombiniert werden. Der q-Parameter sucht volltext über Titel, Beschreibung und Sequenznummer.

Ergebnisse sind nach createdAt DESC sortiert. limit ist auf 200 begrenzt; geblättert wird über offset oder — für tiefe Durchläufe — über cursor zusammen mit sort=_id&order=asc. Siehe Pagination.

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.

Query-Parameter

Beispiel

curl -X GET https://api.codemeta-os.de/v1/tickets \
  -H "X-Tenant-Id: $TENANT" \
  -b cookies.txt

const result = await cm.tickets.list();

Best Practice

Für Dashboards mit Live-Updates eignet sich der Webhook ticket.created besser als ein Polling auf diesen Endpoint. Nutzen Sie das Listing nur für die initiale Befüllung, nicht für das Auf-Stand-Halten.

Antwortcodes

Verwandte Konzepte

• Multi-Tenancy
• Berechtigungen & Scopes
• Pagination

Verwandte Tutorials

• Erstes ticket