SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester
Tasks

Close a shift and hand its open work over. carry moves the work to the next shift, reassign gives it to someone on the next shift, leave keeps it where it is. Only the lead or a shift planner can close a shift

POSThttps://app.softsolz.uk/api/v1/services/tasks/shifts/{id}/close

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Path Params

idstringrequired

Headers

Authorizationstringrequired

Bearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.

Body Params

notesstring

Handover notes, up to 5000 characters.

to_shift_idinteger | null

The shift taking the work.

itemsarray of objects

What to do with each open piece of work.

Response

Response Body

shiftobjectThe closed shift.
handoverobjectThe handover that was made.
failedarray of objectsItems not moved.

Request

curl --request POST \
--url https://app.softsolz.uk/api/v1/services/tasks/shifts/{id}/close \
--header 'Authorization: Bearer sk_live_your_key' \
--header 'Content-Type: application/json' \
--data '{
"notes": "Fridge 2 is warm, keep an eye on it.",
"to_shift_id": 8,
"items": [
{
"assignment_id": 51,
"action": "carry"
}
]
}'

Credentials

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 200

{
"data": {
"shift": {
"id": 7,
"name": "Morning",
"org_unit": {
"id": 1,
"name": "your-name"
},
"starts_at": "2026-01-01T09:00:00.000Z",
"ends_at": "2026-01-01T09:00:00.000Z",
"status": "planned",
"lead": {
"id": 12,
"name": "Sam Lee"
},
"members": [
{
"id": 1,
"name": "your-name",
"role": "your-role"
}
],
"open_count": 1,
"handover_status": "your-handover-status"
},
"handover": {
"id": 3,
"status": "waiting",
"from_shift": {},
"to_shift": {},
"notes": "your-notes",
"items": [
{}
],
"acknowledged_at": "2026-01-01T09:00:00.000Z"
},
"failed": [
{}
]
}
}