Skip to content

Get on-call settings

GET
/organizations/{org_id}/on-call/settings
curl --request GET \
--url https://api.perstat.io/organizations/example/on-call/settings \
--header 'Authorization: Bearer <token>'

Returns the organization’s on-call configuration: enabled state, timezone, rotation mode, escalation stage timings, the currently resolved duty user, and whether the plan includes on-call. Any member may read; a default configuration is returned when nothing has been set up yet.

org_id
required
string
Media typeapplication/json
object
channel_step_minutes
required
integer format: int32
current_duty_user_id

Wer hat JETZT Dienst (aufgelöst); null bei Coverage-Gap.

string | null
enabled
required
boolean
entitled
required

Ist On-Call im Tarif enthalten (monitor.on_call)? Steuert die UI-Sperre.

boolean
escalation_stage1_minutes
required
integer format: int32
escalation_stage2_minutes
required
integer format: int32
manual_duty_user_id

Interner User-UUID des manuellen Diensthabenden (oder null).

string | null
rotation_mode
required

“manual” | “weekly”

string
timezone
required
string
Examplegenerated
{
"channel_step_minutes": 1,
"current_duty_user_id": "example",
"enabled": true,
"entitled": true,
"escalation_stage1_minutes": 1,
"escalation_stage2_minutes": 1,
"manual_duty_user_id": "example",
"rotation_mode": "example",
"timezone": "example"
}