Preview 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/preview"), Headers = { { "Authorization", "Bearer <token>" }, }, Content = new StringContent("{ \"cellId\": \"example\", \"from\": \"2026-04-15T12:00:00Z\", \"operationId\": \"example\", \"reason\": \"example\", \"recipientUserIds\": [ \"example\" ], \"to\": \"2026-04-15T12:00:00Z\" }") { Headers = { ContentType = new MediaTypeHeaderValue("application/*+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/preview"
payload := strings.NewReader("{ \"cellId\": \"example\", \"from\": \"2026-04-15T12:00:00Z\", \"operationId\": \"example\", \"reason\": \"example\", \"recipientUserIds\": [ \"example\" ], \"to\": \"2026-04-15T12:00:00Z\" }")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>") req.Header.Add("Content-Type", "application/*+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");RequestBody body = RequestBody.create(mediaType, "{ \"cellId\": \"example\", \"from\": \"2026-04-15T12:00:00Z\", \"operationId\": \"example\", \"reason\": \"example\", \"recipientUserIds\": [ \"example\" ], \"to\": \"2026-04-15T12:00:00Z\" }");Request request = new Request.Builder() .url("https://api.roundrobinbot.eu/v1/rotations/example/cover-requests/preview") .post(body) .addHeader("Authorization", "Bearer <token>") .addHeader("Content-Type", "application/*+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/preview', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/*+json'}, data: '{ "cellId": "example", "from": "2026-04-15T12:00:00Z", "operationId": "example", "reason": "example", "recipientUserIds": [ "example" ], "to": "2026-04-15T12:00:00Z" }'};
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/preview';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/*+json'}, body: '{ "cellId": "example", "from": "2026-04-15T12:00:00Z", "operationId": "example", "reason": "example", "recipientUserIds": [ "example" ], "to": "2026-04-15T12:00:00Z" }'};
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/preview \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/*+json' \ --data '{ "cellId": "example", "from": "2026-04-15T12:00:00Z", "operationId": "example", "reason": "example", "recipientUserIds": [ "example" ], "to": "2026-04-15T12:00:00Z" }'Requires a Slack member access token. API keys are refused. Returns the proposed intervals and rotation ETag without changing duty or creating a request.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Request Bodyrequired
Section titled “Request Bodyrequired”UTC interval and selected audience for a new cover request.
object
Stable cell identifier from the rotation or personal duty read.
Inclusive requested start, with UTC offset zero.
Caller-generated mutation identity, at most 128 characters. Reuse only for an identical retry.
Optional explanation, at most 2000 characters. Use an empty string when omitted.
Between 1 and 100 distinct eligible Slack user identifiers, excluding the requester.
Exclusive requested end, with UTC offset zero.
Examplegenerated
{ "cellId": "example", "from": "2026-04-15T12:00:00Z", "operationId": "example", "reason": "example", "recipientUserIds": [ "example" ], "to": "2026-04-15T12:00:00Z"}UTC interval and selected audience for a new cover request.
object
Stable cell identifier from the rotation or personal duty read.
Inclusive requested start, with UTC offset zero.
Caller-generated mutation identity, at most 128 characters. Reuse only for an identical retry.
Optional explanation, at most 2000 characters. Use an empty string when omitted.
Between 1 and 100 distinct eligible Slack user identifiers, excluding the requester.
Exclusive requested end, with UTC offset zero.
Examplegenerated
{ "cellId": "example", "from": "2026-04-15T12:00:00Z", "operationId": "example", "reason": "example", "recipientUserIds": [ "example" ], "to": "2026-04-15T12:00:00Z"}UTC interval and selected audience for a new cover request.
object
Stable cell identifier from the rotation or personal duty read.
Inclusive requested start, with UTC offset zero.
Caller-generated mutation identity, at most 128 characters. Reuse only for an identical retry.
Optional explanation, at most 2000 characters. Use an empty string when omitted.
Between 1 and 100 distinct eligible Slack user identifiers, excluding the requester.
Exclusive requested end, with UTC offset zero.
Examplegenerated
{ "cellId": "example", "from": "2026-04-15T12:00:00Z", "operationId": "example", "reason": "example", "recipientUserIds": [ "example" ], "to": "2026-04-15T12:00:00Z"}UTC interval and selected audience for a new cover request.
object
Stable cell identifier from the rotation or personal duty read.
Inclusive requested start, with UTC offset zero.
Caller-generated mutation identity, at most 128 characters. Reuse only for an identical retry.
Optional explanation, at most 2000 characters. Use an empty string when omitted.
Between 1 and 100 distinct eligible Slack user identifiers, excluding the requester.
Exclusive requested end, with UTC offset zero.
Examplegenerated
{ "cellId": "example", "from": "2026-04-15T12:00:00Z", "operationId": "example", "reason": "example", "recipientUserIds": [ "example" ], "to": "2026-04-15T12:00:00Z"}Responses
Section titled “Responses”OK
Conflict evaluation for the proposed terms. A preview does not change duty.
object
Whether every observed conflict permits acknowledgment and has been acknowledged. The write rechecks current state.
Observed conflicts and source uncertainties.
A conflict or an uncertainty affecting the proposed assignment.
object
Whether explicit acknowledgment permits proceeding with this conflict. False means the conflict blocks the write.
The inclusive UTC start of the conflict intersection with the requested interval.
The acknowledgment identifier for this conflict and the previewed terms.
arrangement, manualAvailability, googleCalendar or slackStatus.
The exclusive UTC end of the conflict intersection with the requested interval.
absence, sameCellArrangement or unknownAvailability.
The affected person’s Slack user identifier.
The later of the requested start and preview time. The actual write can begin later.
On a cover acceptance preview only: allowed when the acceptance can be committed from one action, unavailable when the caller cannot accept, conflictReview when conflicts need review first. Null on every other preview.
The requested exclusive UTC end.
The verified full or remaining turn for these terms, or null when the interval does not identify one. Copy this value into the write to record the selection.
object
The inclusive UTC start of the original turn, including any part already served.
fullTurn or remainingTurn.
The exclusive UTC end of the original turn.
Examplegenerated
{ "canCommit": true, "conflicts": [ { "canAcknowledge": true, "from": "2026-04-15T12:00:00Z", "id": "example", "source": "example", "to": "2026-04-15T12:00:00Z", "type": "example", "userId": "example" } ], "effectiveFrom": "2026-04-15T12:00:00Z", "oneClick": "example", "to": "2026-04-15T12:00:00Z", "turnSelection": { "from": "2026-04-15T12:00:00Z", "kind": "example", "to": "2026-04-15T12:00:00Z" }}