Skip to content

Preview cover ending

POST
/v1/rotations/{rotationId}/cover-requests/{requestId}/end/preview
curl --request POST \
--url https://api.roundrobinbot.eu/v1/rotations/example/cover-requests/example/end/preview \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json-patch+json' \
--data '{ "operationId": "example", "expectedRevision": 1, "acknowledgedConflictIds": [ "example" ] }'
rotationId
required
string
requestId
required
string

Revision and conflict acknowledgments for a cover response.

object
operationId

Caller-generated mutation identity, at most 128 characters. Reuse only for an identical retry.

string
expectedRevision

Request revision the caller reviewed.

integer | string format: int64
/^-?(?:0|[1-9]\d*)$/
acknowledgedConflictIds

Exact current conflict identifiers acknowledged by the accepting recipient.

Array<string>
Examplegenerated
{
"operationId": "example",
"expectedRevision": 1,
"acknowledgedConflictIds": [
"example"
]
}

OK

Media typeapplication/json
object
asOfUtc
required
string format: date-time
from
required
string format: date-time
to
required
string format: date-time
complete
required
boolean
segments
required
Array<object>

Effective duty during part of an assignment interval.

object
from
required

The inclusive UTC start.

string format: date-time
to
required

The exclusive UTC end.

string format: date-time
userIds
required

Slack user identifiers of the effective holders. An empty list means no assignee only when resolved is true.

Array<string>
resolved
required

Whether the holders or absence of duty are known for this interval.

boolean
requestRevision
required
integer | string format: int64
/^-?(?:0|[1-9]\d*)$/
Examplegenerated
{
"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
}
],
"requestRevision": 1
}