GuidesConnect
Shifts API
Read and change shifts from your own code, and hear when one is picked up.
5 minute read
The API reads and changes shifts, and sends a webhook when one is picked up. Keys are made per site under Settings, and can be read only.
List shifts
curl "https://api.tessel.example/v1/shifts?site=harbour-street&week=2026-05-11" \ -H "Authorization: Bearer $TESSEL_KEY"Each shift in the response looks like this:
{ "id": "shf_8a2k", "date": "2026-05-16", "start": "08:00", "end": "16:00", "role": "Barista", "person": "Priya Shah", "status": "picked_up", "picked_up_at": "2026-05-15T21:32:00Z"}Open a shift
Send a shift with no person and Tessel offers it the same way it offers a dropped one.
curl https://api.tessel.example/v1/shifts \ -H "Authorization: Bearer $TESSEL_KEY" \ -d site=harbour-street \ -d date=2026-05-16 -d start=08:00 -d end=16:00 -d role=BaristaThe shift.picked_up webhook
When someone takes an open shift, Tessel posts the shift to your webhook address, signed with your key, within a second.