Entity · escalation_alerts

Escalation Alert Schema

Schema-ID

escalation_alert

Collection

escalation_alerts

Permissions

Lesenescalation_alert_view
Anlegenescalation_alert_manage
Ändernescalation_alert_manage
Löschenescalation_alert_manage

Felder

Escalation Alert Schema

escalation_alerts4 Permissions

Schema for validating escalation alert entities with full lifecycle tracking

sourceTypestringerforderlich

Origin that created this alert

Werte

SERVICE_TARGETENTITY_DEADLINESTATUS_TIME_LIMITMANUALWEBHOOKMONITOR

sourceIdstringoptional

ID of the source rule, webhook, or monitor

nullable

linkedEntityTypestringerforderlich

Schema of the linked entity (e.g. ticket, asset)

linkedEntityIduuiderforderlich

UUID of the linked entity

linkedEntityTitlestringerforderlich

Cached title of the linked entity for display

max 500 Zeichen

titlestringerforderlich

Alert title

1–500 Zeichen

descriptionstringoptional

Alert description with additional context

nullable

prioritystringerforderlich

Alert priority

Werte

LOWNORMALHIGHCRITICAL

statusstringerforderlich

Current alert status

Werte

OPENACKNOWLEDGEDSNOOZEDRESOLVEDAUTO_RESOLVEDMUTED

escalationPolicyIduuiderforderlich

Escalation policy UUID governing this alert

currentLevelintegererforderlich

Current escalation level

≥ 1

escalatedAtdatetimeoptional

Timestamp of the last escalation

nullable

acknowledgedByuuidoptional

User UUID who acknowledged the alert

nullable

acknowledgedAtdatetimeoptional

When the alert was acknowledged

nullable

acknowledgedViastringoptional

Channel through which the alert was acknowledged

Werte

PUSHEMAILCALLWEB

nullable

resolvedByuuidoptional

User UUID who resolved the alert

nullable

resolvedAtdatetimeoptional

When the alert was resolved

nullable

resolutionNotestringoptional

Free-text resolution note

max 2000 Zeichennullable

mutedUntildatetimeoptional

Mute expiry timestamp

nullable

mutedByuuidoptional

User UUID who muted the alert

nullable

muteReasonstringoptional

Reason for muting the alert

max 500 Zeichennullable

deduplicationKeystringerforderlich

Key used to deduplicate alerts from the same source

max 500 Zeichenread-only

snoozedUntildatetimeoptional

Snooze expiry timestamp

nullable

ackTokenstringoptional

One-time token for email/external acknowledgement links

read-onlynullable

ackTokenExpiresAtdatetimeoptional

Expiry timestamp for the acknowledgement token

read-onlynullable

timelineobject[]optional

Chronological timeline of alert lifecycle events

Default: []read-only

_idstringoptional

UUIDv7 timeline entry ID

read-only

timestampdatetimeerforderlich

When this event occurred

eventstringerforderlich

Timeline event type

Werte

alert_creatednotification_sentnotification_deliverednotification_failedescalatedacknowledgedreassignedsnoozedsnooze_expiredresolvedauto_resolvedmutedunmutedcomment_added

actorIdstringoptional

User UUID who triggered this event

nullable

actorNamestringoptional

Cached display name of the actor

nullable

metaobjectoptional

Event-specific metadata

nullable

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/escalation_alerts — Liste, paginiert + filterbar
GET /api/v1/escalation_alerts/<id> — Einzelne Entity
POST /api/v1/escalation_alerts — Anlegen
PATCH /api/v1/escalation_alerts/<id> — Teil-Update
DELETE /api/v1/escalation_alerts/<id> — Soft-Delete
GET /api/v1/escalation_alerts/<id>/timeline — Audit + Aktivitäten