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>'

• Production

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. Accepts API keys with the on-call:read scope, subject to current role and resource grants.

Authorizations

• bearer

Parameters

Path Parameters

org_id

required

string

Responses

200

Request succeeded. The response body contains the result.

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

Example^generated

{
  "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"
}

401

Authentication is missing or invalid.

403

The authenticated caller does not have permission to perform this operation.

404

No accessible resource matches the supplied identifier.