DEPRECATED /v2/labor/shifts/{id} - Square API Reference

Update shift

DEPRECATED

/v2/labor/shifts/{id}

Updates an existing Shift.

When adding a Break to a Shift, any earlier Break instances in the Shift have the end_at property set to a valid RFC-3339 datetime string.

When closing a Shift, all Break instances in the Shift must be complete with end_at set on each Break.

Permissions:TIMECARDS_READ, TIMECARDS_WRITE

Guide

Time Tracking with the Labor API

Deprecation date

2025-05-21

Retirement date

2026-05-21

Replaced by

UpdateTimecard

Migration guide

Link to section

Path parameters

Example code

Link to section

string

Required

The ID of the object being updated.

Link to section

Request body

Link to section

shift

Required

The updated Shift object.

Link to section

Response fields

Link to section

shift

The updated Shift.

Link to section

errors

Any errors that occurred during the request.

curl https://connect.squareup.com/v2/labor/shifts/K0YH4CV5462JB \ -X PUT \ -H 'Square-Version: 2025-10-16' \ -H 'Authorization: Bearer ACCESS_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ "shift": { "team_member_id": "ormj0jJJZ5OZIzxrZYJI", "location_id": "PAA1RJZZKXBFG", "start_at": "2019-01-25T03:11:00-05:00", "end_at": "2019-01-25T13:11:00-05:00", "wage": { "title": "Bartender", "hourly_rate": { "amount": 1500, "currency": "USD" }, "tip_eligible": true }, "breaks": [ { "id": "X7GAQYVVRRG6P", "start_at": "2019-01-25T06:11:00-05:00", "end_at": "2019-01-25T06:16:00-05:00", "break_type_id": "REGS1EQR1TPZ5", "name": "Tea Break", "expected_duration": "PT5M", "is_paid": true } ], "declared_cash_tip_money": { "amount": 500, "currency": "USD" }, "version": 1 } }'

{ "shift": { "id": "K0YH4CV5462JB", "team_member_id": "ormj0jJJZ5OZIzxrZYJI", "employee_id": "ormj0jJJZ5OZIzxrZYJI", "location_id": "PAA1RJZZKXBFG", "timezone": "America/New_York", "start_at": "2019-01-25T03:11:00-05:00", "end_at": "2019-01-25T13:11:00-05:00", "wage": { "title": "Bartender", "hourly_rate": { "amount": 1500, "currency": "USD" }, "job_id": "dZtrPh5GSDGugyXGByesVp51", "tip_eligible": true }, "breaks": [ { "id": "X7GAQYVVRRG6P", "start_at": "2019-01-25T06:11:00-05:00", "end_at": "2019-01-25T06:16:00-05:00", "break_type_id": "REGS1EQR1TPZ5", "name": "Tea Break", "expected_duration": "PT5M", "is_paid": true } ], "declared_cash_tip_money": { "amount": 500, "currency": "USD" }, "status": "CLOSED", "version": 2, "created_at": "2019-02-28T00:39:02Z", "updated_at": "2019-02-28T00:42:41Z" } }