API explorerTeams
Create an on-call group (admin or owner)
POST /api/agent/teams/{id}/oncall. Required scopes: oncall:write.
Loading API reference…
Required scopes: oncall:write
POST
bearer oncall:writeheader
AuthorizationBearer <token>A Notify agent token from notify auth login or the dashboard.
Scope: oncall:write
id*stringapplication/json- body
name*stringLength
1 <= length <= 60rotation*escalation?array<>Items
items <= 5Default
[ { "afterMinutes": 5, "target": "next" }, { "afterMinutes": 10, "target": "group" }]Success
application/json- response
group*curl -X POST 'https://example.com/api/agent/teams/string/oncall' \ -H 'Content-Type: application/json' \ -d '{ "name": "string", "rotation": { "memberIds": [ "string" ], "period": "daily", "handoffAt": "string", "timezone": "string" }}'{ "group": { "id": "string", "teamId": "string", "name": "string", "rotation": { "members": [ { "userId": "string", "name": "string", "image": "string" } ], "period": "daily", "handoffAt": "string", "timezone": "string", "startsAt": "2019-08-24T14:15:22Z" }, "escalation": [ { "afterMinutes": 0, "target": "next" } ], "current": { "person": { "userId": "string", "name": "string", "image": "string" }, "startsAt": "2019-08-24T14:15:22Z", "endsAt": "2019-08-24T14:15:22Z", "override": true, "overrideId": "string" }, "upcoming": [ { "person": { "userId": "string", "name": "string", "image": "string" }, "startsAt": "2019-08-24T14:15:22Z", "endsAt": "2019-08-24T14:15:22Z", "override": true, "overrideId": "string" } ], "overrides": [ { "id": "string", "person": { "userId": "string", "name": "string", "image": "string" }, "startsAt": "2019-08-24T14:15:22Z", "endsAt": "2019-08-24T14:15:22Z" } ], "openPageCount": 0, "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" }}