Raw schema
{
"type": "object",
"properties": {
"start": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "string"
}
],
"description": "Unix timestamp (seconds), an ISO 8601 date (2026-10-12 = 00:00 UTC) or an ISO 8601 date-time with a time zone (2026-10-12T09:00:00+01:00 or ...Z)."
},
"end": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "string"
}
],
"description": "Unix timestamp (seconds), an ISO 8601 date (2026-10-12 = 00:00 UTC) or an ISO 8601 date-time with a time zone (2026-10-12T09:00:00+01:00 or ...Z)."
},
"open": {
"description": "true = only open (unassigned) shifts, false = only assigned shifts, omit = both.",
"type": "boolean"
},
"published": {
"description": "true = only published shifts, false = only unpublished (draft) shifts.",
"type": "boolean"
},
"users": {
"description": "Only shifts of these user ids (add 0 to include open shifts).",
"type": "array",
"items": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"locations": {
"description": "Only shifts at these location ids.",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"roles": {
"description": "Only shifts with these role ids.",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"shorter_than_minutes": {
"description": "Only shifts whose elapsed duration is strictly less than this many minutes.",
"type": "number",
"exclusiveMinimum": 0
},
"at_least_minutes": {
"description": "Only shifts whose elapsed duration is this many minutes or more.",
"type": "number",
"minimum": 0
},
"max_results": {
"description": "Most matches to return (1-100, default 100; rotacloud_delete_shifts takes up to 100 ids).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"offset": {
"description": "Position in the range to start reading at; pass the previous reply's next_offset (0 again after a delete).",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"required": [
"start",
"end"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}