API · v1 · stabil
CODEMETA OSDeveloper Center
Konsole öffnen
Entity · ticket_types

Ticket Type Schema

Schema-ID
ticket_type
Collection
ticket_types
Permissions
  • Lesenticket_type_view
  • Anlegenticket_type_create
  • Ändernticket_type_edit
  • Löschenticket_type_delete

Felder

Ticket Type Schema

ticket_types4 Permissions

Schema for validating ticket type (Ticket-Typ) entities

keystringoptional

Machine key stored on tickets (e.g. INCIDENT, REPAIR). Used for SLA tier matching and worker classification. Defaults to a slug derived from the name when omitted.

max 40 ZeichenPatternnullable
namestringerforderlich

Display label (e.g. Störung, Anfrage)

1–100 Zeichen
descriptionstringoptional

Short description shown in settings / tooltip

max 500 Zeichennullable
colorstringoptional

Display color as hex (e.g. #18cc63)

Patternnullable
iconstringoptional

MUI icon name

max 50 Zeichennullable
isActivebooleanerforderlich

Whether this ticket type is available for selection

Default: true
isDefaultbooleanoptional

Whether this is the tenant-level default ticket type pre-selected when creating a ticket. Only one ticket type per tenant should be the default.

Default: false
sortOrderintegeroptional

Display sort order in UI dropdowns

≥ 0Default: 0
defaultServiceTypeIduuidoptional

Default service type (Leistungstyp) pre-selected when recording time on a ticket of this type. Takes priority over the user lastServiceType preference.

nullable
defaultBudgetobjectoptional

Default budget cap auto-applied to tickets of this type on create

nullable
capMinutesintegeroptional

Default hard budget cap in minutes for tickets of this type. Mirrors ticket.budget.capMinutes.

≥ 0nullable
capDisplayUnitstringoptional

How the default cap was entered (round-trip). Mirrors ticket.budget.capDisplayUnit.

Werte
MINUTESHOURSEUR
nullable
capDisplayValuestringoptional

Original default cap value as entered. Mirrors ticket.budget.capDisplayValue.

Patternnullable
capHourlyRateEurstringoptional

Hourly rate used to convert an EUR default cap to minutes. Mirrors ticket.budget.capHourlyRateEur.

Patternnullable
lockStatusKeystringoptional

Optional ticket status the ticket is auto-transitioned into when the cap is reached (the "locked" status). Must be a known status of the ticket workflow. Falls back to the tenant-wide default when unset.

max 100 Zeichennullable

Standard-Endpoints

Diese Resource folgt dem generischen CRUD-Vertrag der Plattform. Lesen Sie die Konventionen für Pagination, Idempotenz, Optimistic Locking und Audit. Die wichtigsten Endpoints:

  • GET /api/v1/ticket_types — Liste, paginiert + filterbar
  • GET /api/v1/ticket_types/<id> — Einzelne Entity
  • POST /api/v1/ticket_types — Anlegen
  • PATCH /api/v1/ticket_types/<id> — Teil-Update
  • DELETE /api/v1/ticket_types/<id> — Soft-Delete
  • GET /api/v1/ticket_types/<id>/timeline — Audit + Aktivitäten

Suche