Offer an unassigned shift
Offer an unassigned shift to one or more employees for their approval.
MCP tool quinyx_write → offer_shift
write Confirm
Works only on unassigned shifts in the published period and only if Offer shift is turned on in Account settings > Compliance settings. Each employee gets a Qmail. The first to accept is assigned the shift, and the others are told the offer is gone. If nobody accepts by the shift start, Quinyx denies the offer. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| shift_id string required | string | Id of an unassigned shift from list_shifts. |
| employee_ids array required | array | Employee ids from list_employees. |
| comment string | string | Why you picked them. The employees see it in their Qmail. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "quinyx_write",
"arguments": {
"operation": "offer_shift",
"arguments": {
"shift_id": "90518",
"employee_ids": [
"3011",
"3027",
"3044"
],
"comment": "Open Friday opening shift after a sick call. First to accept gets it."
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"offer_id": "5521",
"shift_id": "90518",
"status": "pending",
"offered_to": [
"Tom Becker",
"Maria Silva",
"Ana Lopez"
],
"comment": "Open Friday opening shift after a sick call. First to accept gets it."
},
"isError": false
}