Respond to a cover request
using System.Net.Http.Headers;var client = new HttpClient();var request = new HttpRequestMessage{ Method = HttpMethod.Post, RequestUri = new Uri("https://api.roundrobinbot.eu/v1/rotations/example/cover-requests/example/example"), Headers = { { "If-Match", "example" }, { "Authorization", "Bearer <token>" }, }, Content = new StringContent("{ \"operationId\": \"example\", \"expectedRevision\": 1, \"acknowledgedConflictIds\": [ \"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/cover-requests/example/example"
payload := strings.NewReader("{ \"operationId\": \"example\", \"expectedRevision\": 1, \"acknowledgedConflictIds\": [ \"example\" ] }")
req, _ := http.NewRequest("POST", 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, "{ \"operationId\": \"example\", \"expectedRevision\": 1, \"acknowledgedConflictIds\": [ \"example\" ] }");Request request = new Request.Builder() .url("https://api.roundrobinbot.eu/v1/rotations/example/cover-requests/example/example") .post(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: 'POST', url: 'https://api.roundrobinbot.eu/v1/rotations/example/cover-requests/example/example', headers: { 'If-Match': 'example', Authorization: 'Bearer <token>', 'Content-Type': 'application/json-patch+json' }, data: '{ "operationId": "example", "expectedRevision": 1, "acknowledgedConflictIds": [ "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/cover-requests/example/example';const options = { method: 'POST', headers: { 'If-Match': 'example', Authorization: 'Bearer <token>', 'Content-Type': 'application/json-patch+json' }, body: '{ "operationId": "example", "expectedRevision": 1, "acknowledgedConflictIds": [ "example" ] }'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.roundrobinbot.eu/v1/rotations/example/cover-requests/example/example \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json-patch+json' \ --header 'If-Match: example' \ --data '{ "operationId": "example", "expectedRevision": 1, "acknowledgedConflictIds": [ "example" ] }'Requires a Slack member access token, the current expectedRevision and If-Match. Use an action offered by the request capability. Actions are accept, decline, cancel and end. Reuse operationId and the same body when retrying an uncertain result. A missing If-Match returns 428. On 412, refresh the preview before retrying.
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”Revision and conflict acknowledgments for a cover response.
object
Caller-generated mutation identity, at most 128 characters. Reuse only for an identical retry. A repeated operation id is recognised for 30 days; after that it is treated as a new request.
Request revision the caller reviewed.
Exact current conflict identifiers acknowledged by the accepting recipient.
Examplegenerated
{ "operationId": "example", "expectedRevision": 1, "acknowledgedConflictIds": [ "example" ]}Revision and conflict acknowledgments for a cover response.
object
Caller-generated mutation identity, at most 128 characters. Reuse only for an identical retry. A repeated operation id is recognised for 30 days; after that it is treated as a new request.
Request revision the caller reviewed.
Exact current conflict identifiers acknowledged by the accepting recipient.
Examplegenerated
{ "operationId": "example", "expectedRevision": 1, "acknowledgedConflictIds": [ "example" ]}Revision and conflict acknowledgments for a cover response.
object
Caller-generated mutation identity, at most 128 characters. Reuse only for an identical retry. A repeated operation id is recognised for 30 days; after that it is treated as a new request.
Request revision the caller reviewed.
Exact current conflict identifiers acknowledged by the accepting recipient.
Examplegenerated
{ "operationId": "example", "expectedRevision": 1, "acknowledgedConflictIds": [ "example" ]}Revision and conflict acknowledgments for a cover response.
object
Caller-generated mutation identity, at most 128 characters. Reuse only for an identical retry. A repeated operation id is recognised for 30 days; after that it is treated as a new request.
Request revision the caller reviewed.
Exact current conflict identifiers acknowledged by the accepting recipient.
Examplegenerated
{ "operationId": "example", "expectedRevision": 1, "acknowledgedConflictIds": [ "example" ]}Responses
Section titled “Responses”OK
Committed mutation result. DeliveryState describes publication progress, not confirmed Slack receipt.
object
A permitted cover request, its rotation name and caller-specific capabilities.
object
The request.
object
The request identifier.
The rotation identifier.
The identifier of the lane in a window.
The user who made the request.
The users asked to cover.
The recipients who declined.
The inclusive interval start.
The exclusive interval end.
The reason given with the request.
The revision of the request.
The lifecycle state of the request.
The user who accepted. Absent until accepted.
The assignment identifier created by acceptance. Absent until accepted.
upcoming, running or ended for the requested interval at the instant the response is built.
The actions available to the caller.
object
Whether the caller may accept the request.
Whether the caller may decline the request.
Whether the caller may cancel the request.
Whether the caller may end the accepted cover.
The reason the actions are unavailable. Absent when they are available.
The same word as reason, or null when the actions are available.
The name of the rotation.
The instant the state, phase and capabilities were evaluated.
True while the request is pending or accepted.
True when the caller may accept, decline, cancel or end the request.
The earliest later instant at which the state, phase, active or actionable changes by the clock alone. Null when none will.
An interval assignment. Its recorded terms remain distinct from actual served history.
object
The arrangement identifier.
The rotation identifier.
The identifier of the lane in a window.
The assigned person’s Slack user identifier.
The inclusive UTC start.
The exclusive UTC end.
The arrangement revision used when changing or ending it.
active or cancelled. An active record can describe an interval that has already ended.
directAssignment, acceptedCover or swapLeg. Direct-assignment writes change or end only directAssignment.
upcoming, running or ended, from from and to at the time the response is built.
The next instant at which phase changes, or null once it has ended.
Original duty holders recorded before the first assignment, with completeness for this interval. Later edits retain that original record.
object
Distinct Slack user identifiers in the recorded portion of the arrangement interval.
Whether original duty is known throughout the interval. False includes assignments without an original record.
Original duty segments on detail reads. Null on list reads or when no original record is available.
object
The UTC time when the original duty was evaluated.
The inclusive UTC start of the returned interval.
The exclusive UTC end of the returned interval.
Whether every returned segment is resolved. An extension beyond the original recorded interval is unresolved.
Original holders by interval, including periods with no assignee and unresolved periods.
Effective duty during part of an assignment interval.
object
The inclusive UTC start.
The exclusive UTC end.
Slack user identifiers of the effective holders. An empty list means no assignee only when resolved is true.
Whether the holders or absence of duty are known for this interval.
The recorded full or remaining turn, or null when no verified selection was saved. Use the arrangement’s From and To for the affected interval.
object
fullTurn or remainingTurn.
The inclusive UTC start of the original turn, including any part already served.
The exclusive UTC end of the original turn.
Examplegenerated
{ "operationId": "example", "rotationVersion": 1, "effectiveFrom": "2026-04-15T12:00:00Z", "request": { "request": { "id": "example", "rotationId": "example", "cellId": "example", "requesterUserId": "example", "recipientUserIds": [ "example" ], "declinedUserIds": [ "example" ], "from": "2026-04-15T12:00:00Z", "to": "2026-04-15T12:00:00Z", "reason": "example", "revision": 1, "state": "example", "acceptedUserId": "example", "arrangementId": "example", "phase": "example" }, "capability": { "canAccept": true, "canDecline": true, "canCancel": true, "canEnd": true, "reason": "example", "reasonCode": "example" }, "rotationName": "example", "asOfUtc": "2026-04-15T12:00:00Z", "active": true, "actionable": true, "changesAtUtc": "2026-04-15T12:00:00Z" }, "arrangements": [ { "id": "example", "rotationId": "example", "cellId": "example", "userId": "example", "from": "2026-04-15T12:00:00Z", "to": "2026-04-15T12:00:00Z", "revision": 1, "state": "example", "kind": "example", "phase": "example", "changesAtUtc": "2026-04-15T12:00:00Z", "origin": { "userIds": [ "example" ], "complete": true }, "originalSnapshot": { "asOfUtc": "2026-04-15T12:00:00Z", "from": "2026-04-15T12:00:00Z", "to": "2026-04-15T12:00:00Z", "complete": true, "segments": [ { "from": "2026-04-15T12:00:00Z", "to": "2026-04-15T12:00:00Z", "userIds": [ "example" ], "resolved": true } ] }, "turnSelection": { "kind": "example", "from": "2026-04-15T12:00:00Z", "to": "2026-04-15T12:00:00Z" } } ], "deliveryState": "example"}