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
POST
https://app.softsolz.uk/api/v1/services/tasks/shifts/{id}/closeRecent Requests
Kept only in this browserTimeStatusTook
Send a request with Try it to see it here.
Path Params
idstringrequiredHeaders
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Body Params
notesstringHandover notes, up to 5000 characters.
to_shift_idinteger | nullThe shift taking the work.
itemsarray of objectsWhat 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": [ {} ] }}