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

Escalation Policy Schema

Schema-ID
escalation_policy
Collection
escalation_policies
Permissions
  • Lesenescalation_policy_view
  • Anlegenescalation_policy_manage
  • Ändernescalation_policy_manage
  • Löschenescalation_policy_manage

Felder

Escalation Policy Schema

escalation_policies4 Permissions

Schema for validating escalation policy entities with multi-level notification chains

namestringerforderlich

Policy name

1–200 Zeichen
descriptionstringoptional

Policy description

nullable
conditionsobjectoptional

Conditions that must match for this policy to apply

nullable
prioritiesstring[]optional

Alert priorities this policy applies to

customerTiersstring[]optional

Customer tiers this policy applies to

afterHoursOnlybooleanoptional

Whether this policy only applies outside business hours

schemasstring[]optional

Entity schemas this policy applies to (e.g. ticket, asset)

levelsobject[]erforderlich

Escalation levels in order

_idstringoptional

UUIDv7 level ID

read-only
levelintegererforderlich

Escalation level (1 = first responder)

≥ 1
namestringerforderlich

Level display name

max 200 Zeichen
recipientsobject[]erforderlich

Who to notify at this level

typestringerforderlich

Recipient type

Werte
USERON_CALLTEAMROLEPLACEHOLDER
refstringerforderlich

Reference ID (UUID or placeholder token)

labelstringoptional

Human-readable display label (cached for UI)

nullable
notificationStepsobject[]erforderlich

Ordered notification steps within this level

orderintegererforderlich

Step execution order

channelstringerforderlich

Notification channel

Werte
PUSHEMAILCALL
delayMinutesintegererforderlich

Delay in minutes before sending this step

≥ 0
escalationTimeoutMinutesintegererforderlich

Minutes to wait before escalating to next level

≥ 1
maxRetriesintegeroptional

Maximum notification retries at this level

≥ 0Default: 2
retryIntervalMinutesintegeroptional

Minutes between retries

≥ 1Default: 2
fallbackActionstringoptional

Action when all levels are exhausted without acknowledgement

Werte
NOTIFY_ALLCREATE_TICKETNONE
Default: "NONE"
fallbackRecipientsobject[]optional

Recipients for fallback action

Default: []
typestringerforderlich

Recipient type

Werte
USERON_CALLTEAMROLEPLACEHOLDER
refstringerforderlich

Reference ID (UUID or placeholder token)

labelstringoptional

Human-readable display label (cached for UI)

nullable
isDefaultbooleanerforderlich

Whether this is the default escalation policy

isActivebooleanerforderlich

Whether this escalation policy is active

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

Suche