Easyteam Embedded
GuidesAPIWhite-Label UIs
GuidesAPIWhite-Label UIs
  1. Timesheets
  • Getting started
    • Authentication
      • Authentication Quick Start
      • Exchange Token
    • Permissions
      • Create Access Role
      • List Access Roles
      • Get Access Role
      • Update Access Role
      • Delete Access Role
  • Organizations
    • List Organizations
    • Get Organization
    • Get Organization by External ID
    • Create Organization
    • Create Organization With Defaults
    • Sync Locations
    • Update Organization
    • Delete Organization
    • Delete Organization by External ID
  • Locations
    • Retrieve all locations
    • Retrieve a specific location
    • Retrieve a specific location by external ID
    • Create a new location
    • Update a specific location
    • Delete a specific location
    • Retrieve timesheets for a specific location
    • Retrieve staff members for a specific location
  • Staff members
    • Retrieve all staff members
    • Retrieve a specific staff member
    • Retrieve a staff member by external ID
    • Retrieve staff member locations
    • Create a new staff member
    • Synchronize staff members
    • Update a specific staff member
    • Delete a specific staff member
  • Roles
    • Create a new role
    • Retrieve all roles
    • Retrieve a specific role
    • Update a specific role
    • Delete a specific role
  • Time Tracking
    • Retrieve staff member shift state
    • Clock in a staff member
    • Clock out a staff member
  • Breaks
    • Retrieve break types for a specific location
    • Create a new break type for a location
    • Update a specific break type
    • Delete a specific break type
  • Timesheets
    • Retrieve all shifts
      GET
    • Retrieve a specific shift
      GET
    • Export shifts
      GET
    • Generate per-employee shift reports
      GET
    • Generate shift reports
      GET
    • Create a new shift
      POST
    • Update a specific shift
      PATCH
    • Delete a specific shift
      DELETE
    • Delete all shifts on a specific date
      DELETE
  • Time Off
    • Retrieve all time off policies
    • Retrieve a policy
    • List all policy types
    • Create Policy
    • Update Policy
    • Activate Policy
    • Deactivate Policy
    • Get Worker Policies
    • List all worker policies
  • Requests and Approval
    • Get Time-Off Request
    • List Time-Offs
    • Create a time off request
    • Update Time-Off Request
    • Delete Time-Off Request
    • Approve Time-Off Request
    • Decline Time-Off Request
  • Shift Notes
    • Working with shift notes
    • List shift notes from current shift
    • Create shift note on current shift
  • Schedules
    • List all schedule entries
    • Get details for a schedule
    • Create schedule entry
    • Bulk copy schedule shifts
    • Update schedule entry
    • Remove schedule entry
    • List all draft schedule entries
    • Get details for a draft entry
    • Create draft schedule entry
    • Update draft entry
    • Remove draft schedule entry
    • Publish draft schedule
    • List open shifts
    • Get details for an open shift
    • Create open shift
    • Update open shift
    • Remove open shift
    • Claim open shift
    • Retract open shift submission
    • Create open shift preference
    • Retract open shift preference
    • Update open shift preference
    • Remove open shift preference
    • Assign or accept open shift preference
    • Bulk assign or accept open shift preferences
  • Settings
    • Retrieve organization time off settings
    • Update organization time off settings
  • Notifications
    • Coming soon
  1. Timesheets

Update a specific shift

PATCH
/api/timesheets/{id}
Updates the details of a specific shift by its ID.

Request

Path Params

Body Params application/json

Examples

Responses

🟢200OK
application/json
The shift was updated successfully.
Body

đźź 400Bad Request
đźź 404Record Not Found
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH '/api/timesheets/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "endTime": "2023-10-27T17:30:00Z",
    "breaks": [
        {
            "startTime": "2023-10-27T12:00:00Z",
            "endTime": "2023-10-27T13:00:00Z",
            "typeId": "break_type_002",
            "paid": true,
            "name": "Extended Lunch",
            "mandatory": false,
            "frequencyMinutes": 180,
            "durationInSettingsMinutes": 60
        }
    ]
}'
Response Response Example
200 - Success
{
    "id": "shift_001",
    "employeeId": "emp_001",
    "locationId": "loc_001",
    "roleId": "role_001",
    "startTime": "2023-10-27T09:00:00Z",
    "endTime": "2023-10-27T17:30:00Z",
    "breaks": [
        {
            "startTime": "2023-10-27T12:00:00Z",
            "endTime": "2023-10-27T13:00:00Z",
            "typeId": "break_type_002",
            "paid": true,
            "name": "Extended Lunch",
            "mandatory": false,
            "frequencyMinutes": 180,
            "durationInSettingsMinutes": 60
        }
    ],
    "hourlyWage": 20,
    "totalPaidBreaks": 60,
    "totalUnpaidBreaks": 0,
    "duration": 510,
    "payableDuration": 450,
    "utcOffset": -240,
    "utcStartTime": "2023-10-27T13:00:00Z",
    "utcEndTime": "2023-10-27T21:30:00Z",
    "locked": false,
    "active": true,
    "createdAt": "2023-10-27T09:00:00Z",
    "updatedAt": "2023-10-27T17:30:00Z",
    "deletedAt": null
}
Modified at 2025-01-05 16:07:28
Previous
Create a new shift
Next
Delete a specific shift