Schedule Replicas
API endpoints for schedule replicas
The schedule replica object
When this schedule replica was first created
"2021-08-17T13:28:57.801578Z"
Unique identifier of the schedule replica
"01G0J1EXE7AXZ2C93K61WBPYEH"
The ID of a user in the external provider that will be assigned whenever nobody is on-call in the incident.io schedule. External providers typically require someone to always be on-call, so this user fills gaps where incident.io has no one scheduled.
"PA7AXXN"
The external provider where this schedule is replicated to
native, pagerduty, opsgenie, jsm "pagerduty"
The ID of the schedule in the external provider that this replica syncs to. For PagerDuty this is the schedule ID (e.g. PO8107X), for Opsgenie the schedule ID, and for Jira Service Management the schedule ID.
"PO8107X"
The ID of the incident.io schedule that this replica is syncing from
"01FDAG4SAP5TYPT98WGR2N7W91"
The specific rotation and layer combinations from the schedule that are being replicated. Each source identifies a single layer within a rotation to sync to the external provider.
Show child attributes
Show child attributes
[
{
"layer_id": "01G0J1EXE7AXZ2C93K61WBPYNH",
"rotation_id": "01G0J1EXE7AXZ2C93K61WBPYEH"
}
]
When this schedule replica was last updated
"2021-08-17T13:28:57.801578Z"
The mapping status of each incident.io user in the schedule to their corresponding user in the external provider. Users must be mapped for the replica to sync their on-call shifts correctly.
Show child attributes
Show child attributes
[
{
"external_user_id": "PJYTRGS",
"user_id": "01G0J1EXE7AXZ2C93K61WBPYEH"
}
]
The most recent error encountered while syncing this replica to the external provider, if any. Common errors include unmapped users or connectivity issues with the external provider. Null if the last sync was successful.
"Failed to find external user for Milly"
When the replica was last successfully synced to the external provider. Null if the replica has never been successfully synced.
"2023-11-07T13:33:30Z"
How many days ahead to mirror this schedule into the external provider. Defaults to 14 if not set; maximum 90.
1 <= x <= 9014
Was this page helpful?
{
"created_at": "2021-08-17T13:28:57.801578Z",
"id": "01G0J1EXE7AXZ2C93K61WBPYEH",
"replica_fallback_user_id": "PA7AXXN",
"replica_provider": "pagerduty",
"replica_provider_id": "PO8107X",
"schedule_id": "01FDAG4SAP5TYPT98WGR2N7W91",
"sources": [
{
"layer_id": "01G0J1EXE7AXZ2C93K61WBPYNH",
"rotation_id": "01G0J1EXE7AXZ2C93K61WBPYEH"
}
],
"updated_at": "2021-08-17T13:28:57.801578Z",
"user_statuses": [
{
"external_user_id": "PJYTRGS",
"user_id": "01G0J1EXE7AXZ2C93K61WBPYEH"
}
],
"last_sync_error": "Failed to find external user for Milly",
"last_synced_at": "2023-11-07T13:33:30Z",
"mirror_window_days": 14
}