Set who is on duty
using System.Net.Http.Headers;var client = new HttpClient();var request = new HttpRequestMessage{ Method = HttpMethod.Put, RequestUri = new Uri("https://api.roundrobinbot.eu/v1/rotations/example/on-call"), Headers = { { "If-Match", "example" }, { "Authorization", "Bearer <token>" }, }, Content = new StringContent("{ \"userIds\": [ \"example\" ] }") { Headers = { ContentType = new MediaTypeHeaderValue("application/json-patch+json") } }};using (var response = await client.SendAsync(request)){ response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync(); Console.WriteLine(body);}package main
import ( "fmt" "strings" "net/http" "io")
func main() {
url := "https://api.roundrobinbot.eu/v1/rotations/example/on-call"
payload := strings.NewReader("{ \"userIds\": [ \"example\" ] }")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("If-Match", "example") req.Header.Add("Authorization", "Bearer <token>") req.Header.Add("Content-Type", "application/json-patch+json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close() body, _ := io.ReadAll(res.Body)
fmt.Println(res) fmt.Println(string(body))
}OkHttpClient client = new OkHttpClient();
MediaType mediaType = MediaType.parse("application/json-patch+json");RequestBody body = RequestBody.create(mediaType, "{ \"userIds\": [ \"example\" ] }");Request request = new Request.Builder() .url("https://api.roundrobinbot.eu/v1/rotations/example/on-call") .put(body) .addHeader("If-Match", "example") .addHeader("Authorization", "Bearer <token>") .addHeader("Content-Type", "application/json-patch+json") .build();
Response response = client.newCall(request).execute();import axios from 'axios';
const options = { method: 'PUT', url: 'https://api.roundrobinbot.eu/v1/rotations/example/on-call', headers: { 'If-Match': 'example', Authorization: 'Bearer <token>', 'Content-Type': 'application/json-patch+json' }, data: '{ "userIds": [ "example" ] }'};
try { const { data } = await axios.request(options); console.log(data);} catch (error) { console.error(error);}const url = 'https://api.roundrobinbot.eu/v1/rotations/example/on-call';const options = { method: 'PUT', headers: { 'If-Match': 'example', Authorization: 'Bearer <token>', 'Content-Type': 'application/json-patch+json' }, body: '{ "userIds": [ "example" ] }'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PUT \ --url https://api.roundrobinbot.eu/v1/rotations/example/on-call \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json-patch+json' \ --header 'If-Match: example' \ --data '{ "userIds": [ "example" ] }'Puts the people you name on duty, replacing whoever holds the shift now. They must be members of the rotation, and userIds must name at least one: an empty list is refused rather than read as “take everybody off duty”. Answers with the new on-call state and a fresh ETag.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Header Parameters
Section titled “Header Parameters”The ETag from your last read of this resource, sent back exactly as you received it, quotes included. The write happens only if nothing changed in between: a stale validator is answered 412 and nothing is written. Send * to write against whatever is current on purpose. Omitting the header is 428, never an unconditional write. https://docs.roundrobinbot.eu/api/conventions/#conditional-writes
Request Bodyrequired
Section titled “Request Bodyrequired”The body of PUT /v1/rotations/{rotationId}/on-call: who should be on duty.
object
The Slack user ids to put on duty. At least one, and each must be a member of the rotation.
Examplegenerated
{ "userIds": [ "example" ]}The body of PUT /v1/rotations/{rotationId}/on-call: who should be on duty.
object
The Slack user ids to put on duty. At least one, and each must be a member of the rotation.
Examplegenerated
{ "userIds": [ "example" ]}The body of PUT /v1/rotations/{rotationId}/on-call: who should be on duty.
object
The Slack user ids to put on duty. At least one, and each must be a member of the rotation.
Examplegenerated
{ "userIds": [ "example" ]}The body of PUT /v1/rotations/{rotationId}/on-call: who should be on duty.
object
The Slack user ids to put on duty. At least one, and each must be a member of the rotation.
Examplegenerated
{ "userIds": [ "example" ]}Responses
Section titled “Responses”OK
Current on-call assignments for a rotation. Responses with externalAssignments have no ETag; read the assignment freshness and coverage fields on each response.
object
Current external assignment summary, including unmapped participants, empty slots and the next known boundary.
object
UTC instant used to evaluate current assignments and coverage.
Freshness: fresh, stale or unavailable. Fresh data covers asOfUtc, agrees with synchronized assignments and has no failed read at or after the last success.
Coverage: assigned when a user assignment is active; empty when only explicit empty assignments are active; gap for a confirmed interval with no assignments; otherwise unknown.
Time of the last successful provider read, or null when none is recorded.
Time of the last failed provider read, or null when none is recorded.
Inclusive start of the saved provider snapshot. Check state before using its coverage.
Exclusive end of the saved provider snapshot. Later coverage is unknown.
Synchronized assignments active at asOfUtc, including unmapped participants, duplicate assignments and explicit empty slots.
One external assignment interval, including an explicitly unassigned slot.
object
Stable local identity of a synchronized occurrence. Null for a future assignment without a synchronized identity.
Cell holding the synchronized assignment, or null for a future assignment without a stored cell.
Mapped Slack user ID. Null for unmapped participants and explicit empty slots.
Display label for an unmapped participant: provider name, email address or participant ID. Null for mapped users and empty slots.
Provider email address when available. Null for explicit empty slots or when no email is available.
Inclusive start of this assignment interval in UTC.
Exclusive end of this assignment interval in UTC.
Provider metadata for this assignment.
object
Assignment member kind: user or empty.
Provider participant ID for a user assignment. Null for an empty slot.
Provider source type: schedule_rotation, custom_shift, schedule_rotation_override or custom_shift_override.
Provider rotation ID for a rotation or rotation-override source.
Provider custom-shift ID for a custom-shift or custom-shift-override source.
Provider override ID for an override source.
Original provider start of the occurrence in UTC.
Provider end of the occurrence in UTC.
Number of current assignments, including explicit empty slots. This is an assignment count, not a staffing target.
Number of current user assignments, including unmapped participants and duplicate assignments.
Last provider read failure code, or null when none is recorded. Check state and the read timestamps for current freshness.
Distinct current responders, deduplicated by Slack user ID when mapped and provider participant ID otherwise.
Distinct provider participant IDs among current user assignments.
Current user assignments without a Slack mapping. Duplicate assignments count separately.
Current assignments that the provider explicitly leaves unassigned.
Next known boundary after asOfUtc, or null when none is known. Stale data supplies known ends only, without future starts.
object
UTC instant of the assignment boundary.
Assignments starting at atUtc, available only from a fresh provider snapshot.
One external assignment interval, including an explicitly unassigned slot.
object
Stable local identity of a synchronized occurrence. Null for a future assignment without a synchronized identity.
Cell holding the synchronized assignment, or null for a future assignment without a stored cell.
Mapped Slack user ID. Null for unmapped participants and explicit empty slots.
Display label for an unmapped participant: provider name, email address or participant ID. Null for mapped users and empty slots.
Provider email address when available. Null for explicit empty slots or when no email is available.
Inclusive start of this assignment interval in UTC.
Exclusive end of this assignment interval in UTC.
Provider metadata for this assignment.
object
Assignment member kind: user or empty.
Provider participant ID for a user assignment. Null for an empty slot.
Provider source type: schedule_rotation, custom_shift, schedule_rotation_override or custom_shift_override.
Provider rotation ID for a rotation or rotation-override source.
Provider custom-shift ID for a custom-shift or custom-shift-override source.
Provider override ID for an override source.
Original provider start of the occurrence in UTC.
Provider end of the occurrence in UTC.
Current assignments whose end is later than atUtc.
One external assignment interval, including an explicitly unassigned slot.
object
Stable local identity of a synchronized occurrence. Null for a future assignment without a synchronized identity.
Cell holding the synchronized assignment, or null for a future assignment without a stored cell.
Mapped Slack user ID. Null for unmapped participants and explicit empty slots.
Display label for an unmapped participant: provider name, email address or participant ID. Null for mapped users and empty slots.
Provider email address when available. Null for explicit empty slots or when no email is available.
Inclusive start of this assignment interval in UTC.
Exclusive end of this assignment interval in UTC.
Provider metadata for this assignment.
object
Assignment member kind: user or empty.
Provider participant ID for a user assignment. Null for an empty slot.
Provider source type: schedule_rotation, custom_shift, schedule_rotation_override or custom_shift_override.
Provider rotation ID for a rotation or rotation-override source.
Provider custom-shift ID for a custom-shift or custom-shift-override source.
Provider override ID for an override source.
Original provider start of the occurrence in UTC.
Provider end of the occurrence in UTC.
Current assignments ending at atUtc.
One external assignment interval, including an explicitly unassigned slot.
object
Stable local identity of a synchronized occurrence. Null for a future assignment without a synchronized identity.
Cell holding the synchronized assignment, or null for a future assignment without a stored cell.
Mapped Slack user ID. Null for unmapped participants and explicit empty slots.
Display label for an unmapped participant: provider name, email address or participant ID. Null for mapped users and empty slots.
Provider email address when available. Null for explicit empty slots or when no email is available.
Inclusive start of this assignment interval in UTC.
Exclusive end of this assignment interval in UTC.
Provider metadata for this assignment.
object
Assignment member kind: user or empty.
Provider participant ID for a user assignment. Null for an empty slot.
Provider source type: schedule_rotation, custom_shift, schedule_rotation_override or custom_shift_override.
Provider rotation ID for a rotation or rotation-override source.
Provider custom-shift ID for a custom-shift or custom-shift-override source.
Provider override ID for an override source.
Original provider start of the occurrence in UTC.
Provider end of the occurrence in UTC.
Rotation ID.
Current mapped Slack assignments. An empty list does not establish a coverage gap: check externalAssignments or unmappedExternalDuty.
One current mapped Slack assignment. A user can appear more than once when they hold multiple assignments.
object
Slack user ID of the person on duty.
Position in the native turn order. External assignments have no native turn order.
Cell holding this assignment.
Lane containing the cell. Lanes for external assignments do not identify provider roles.
Lane name, when available.
Window containing the cell. External assignment windows do not define provider recurrence.
Window name, when available.
Assignment start in UTC, when known.
Exclusive assignment end in UTC, when known.
Members skipped for absence when this assignment began.
A member skipped because of an absence at assignment time.
object
Slack user ID of the skipped member.
Absence start in UTC, when known.
Absence end in UTC, when known.
Absence source: googleCalendar or internalAvailability. Null when the source is unknown.
Single unmapped duty for an external schedule without externalAssignments. Null when externalAssignments is present.
object
Provider email address.
Provider display name, when available.
Exclusive assignment end in UTC, when known.
Directory records for current mapped Slack users and skipped members when ?expand=users is requested. Null otherwise. Expansion disables ETag validation.
A Slack user, as Round Robin knows them.
object
The Slack user id.
The workspace that owns this person’s directory entry, which under Enterprise Grid can differ from the calling key’s workspace.
Null when the install was never granted users:read.email, not only when unknown.
A Slack Connect person: visible through a shared channel, never a member of the workspace.
Deactivated in Slack, or gone from the workspace. These people are still answered rather than hidden, so an id a rotation still names resolves to something you can render.
The person’s Slack avatar, at 192px.
The person’s Slack time zone, as an IANA identifier (Europe/Rome). Absent when Round Robin has not seen one for them.
Examplegenerated
{ "externalAssignments": { "asOfUtc": "2026-04-15T12:00:00Z", "state": "example", "coverage": "example", "lastSuccessfulReadUtc": "2026-04-15T12:00:00Z", "lastReadFailureUtc": "2026-04-15T12:00:00Z", "knownFromUtc": "2026-04-15T12:00:00Z", "knownUntilUtc": "2026-04-15T12:00:00Z", "current": [ { "localAssignmentId": "example", "cellId": "example", "user": "example", "externalName": "example", "externalEmail": "example", "sinceUtc": "2026-04-15T12:00:00Z", "untilUtc": "2026-04-15T12:00:00Z", "externalAssignment": { "memberKind": "example", "participantId": "example", "sourceType": "example", "rotationId": "example", "shiftId": "example", "overrideId": "example", "originalStartUtc": "2026-04-15T12:00:00Z", "originalEndUtc": "2026-04-15T12:00:00Z" } } ], "requiredAssignmentCount": 1, "assignedAssignmentCount": 1, "lastReadFailure": "example", "distinctResponderCount": 1, "distinctParticipantCount": 1, "unmappedAssignmentCount": 1, "emptyAssignmentCount": 1, "nextChange": { "atUtc": "2026-04-15T12:00:00Z", "starting": [ { "localAssignmentId": "example", "cellId": "example", "user": "example", "externalName": "example", "externalEmail": "example", "sinceUtc": "2026-04-15T12:00:00Z", "untilUtc": "2026-04-15T12:00:00Z", "externalAssignment": { "memberKind": "example", "participantId": "example", "sourceType": "example", "rotationId": "example", "shiftId": "example", "overrideId": "example", "originalStartUtc": "2026-04-15T12:00:00Z", "originalEndUtc": "2026-04-15T12:00:00Z" } } ], "continuing": [ { "localAssignmentId": "example", "cellId": "example", "user": "example", "externalName": "example", "externalEmail": "example", "sinceUtc": "2026-04-15T12:00:00Z", "untilUtc": "2026-04-15T12:00:00Z", "externalAssignment": { "memberKind": "example", "participantId": "example", "sourceType": "example", "rotationId": "example", "shiftId": "example", "overrideId": "example", "originalStartUtc": "2026-04-15T12:00:00Z", "originalEndUtc": "2026-04-15T12:00:00Z" } } ], "ending": [ { "localAssignmentId": "example", "cellId": "example", "user": "example", "externalName": "example", "externalEmail": "example", "sinceUtc": "2026-04-15T12:00:00Z", "untilUtc": "2026-04-15T12:00:00Z", "externalAssignment": { "memberKind": "example", "participantId": "example", "sourceType": "example", "rotationId": "example", "shiftId": "example", "overrideId": "example", "originalStartUtc": "2026-04-15T12:00:00Z", "originalEndUtc": "2026-04-15T12:00:00Z" } } ] } }, "rotationId": "example", "onCall": [ { "userId": "example", "turn": 1, "cellId": "example", "laneId": "example", "laneName": "example", "windowId": "example", "windowName": "example", "since": "2026-04-15T12:00:00Z", "until": "2026-04-15T12:00:00Z", "skippedForAbsence": [ { "userId": "example", "from": "2026-04-15T12:00:00Z", "until": "2026-04-15T12:00:00Z", "source": "example" } ] } ], "unmappedExternalDuty": { "email": "example", "name": "example", "until": "2026-04-15T12:00:00Z" }, "users": [ { "id": "example", "teamId": "example", "displayName": "example", "realName": "example", "email": "example", "isGuest": true, "isExternal": true, "isDeleted": true, "avatarUrl": "example", "timeZone": "example" } ]}Bad Request
object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}Unauthorized
object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}Forbidden
object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}Not Found
object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}Conflict
object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}Precondition Failed
object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}Precondition Required
object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}