Skip to main content
POST
/
v2
/
schedules
/
{schedule_id}
/
replicas
CreateScheduleReplica
curl --request POST \
  --url https://api.incident.io/v2/schedules/{schedule_id}/replicas \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "schedule_replica": {
    "replica_fallback_user_id": "PA7AXXN",
    "replica_provider": "pagerduty",
    "replica_provider_id": "PO8107X",
    "sources": [
      {
        "layer_id": "01G0J1EXE7AXZ2C93K61WBPYEH",
        "rotation_id": "01G0J1EXE7AXZ2C93K61WBPYEH"
      }
    ]
  }
}
'
{
  "schedule_replica": {
    "created_at": "2021-08-17T13:28:57.801578Z",
    "id": "01G0J1EXE7AXZ2C93K61WBPYEH",
    "last_sync_error": "Failed to find external user for Milly",
    "last_synced_at": "2023-11-07T13:33:30Z",
    "replica_fallback_user_id": "PA7AXXN",
    "replica_provider": "pagerduty",
    "replica_provider_id": "PO8107X",
    "schedule_id": "01G0J1EXE7AXZ2C93K61WBPYEH",
    "sources": [
      {
        "layer_id": "01G0J1EXE7AXZ2C93K61WBPYEH",
        "rotation_id": "01G0J1EXE7AXZ2C93K61WBPYEH"
      }
    ],
    "updated_at": "2021-08-17T13:28:57.801578Z",
    "user_statuses": [
      {
        "external_user_id": "PJYTRGS",
        "user_id": "01G0J1EXE7AXZ2C93K61WBPYEH"
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

API key from your incident.io dashboard (Settings → API keys)

Path Parameters

schedule_id
string
required

The schedule to create a replica for

Example:

"01FDAG4SAP5TYPT98WGR2N7W91"

Body

application/json
schedule_replica
object
required
Example:
{
"replica_fallback_user_id": "PA7AXXN",
"replica_provider": "pagerduty",
"replica_provider_id": "PO8107X",
"sources": [
{
"layer_id": "01G0J1EXE7AXZ2C93K61WBPYEH",
"rotation_id": "01G0J1EXE7AXZ2C93K61WBPYEH"
}
]
}

Response

201 - application/json

Created response.

schedule_replica
object
required
Example:
{
"created_at": "2021-08-17T13:28:57.801578Z",
"id": "01G0J1EXE7AXZ2C93K61WBPYEH",
"last_sync_error": "Failed to find external user for Milly",
"last_synced_at": "2023-11-07T13:33:30Z",
"replica_fallback_user_id": "PA7AXXN",
"replica_provider": "pagerduty",
"replica_provider_id": "PO8107X",
"schedule_id": "01G0J1EXE7AXZ2C93K61WBPYEH",
"sources": [
{
"layer_id": "01G0J1EXE7AXZ2C93K61WBPYEH",
"rotation_id": "01G0J1EXE7AXZ2C93K61WBPYEH"
}
],
"updated_at": "2021-08-17T13:28:57.801578Z",
"user_statuses": [
{
"external_user_id": "PJYTRGS",
"user_id": "01G0J1EXE7AXZ2C93K61WBPYEH"
}
]
}