Deputy API

12 endpoints for Deputy, each at its own method and path, called with your API key. Open an endpoint for its inputs, examples and response.

Base URL: https://cotlet.dev/api/v1/deputy
Connects with: Your own Deputy account (Location Manager or System Administrator to approve time and pay, Supervisor for the time part only)
Integration page: Deputy

Read (6)

Return data and change nothing in the account.

Deputy Endpoints: Read
Endpoint	Description
GET /locations	Locations of your Deputy install with their IDs.
GET /employees	Team members of a location with their IDs.
GET /locations/{location_id}/shifts	Shifts of a location between two dates, draft, open and published.
GET /locations/{location_id}/timesheets	Timesheets of a location, oldest first, pending or approved.
GET /timesheets/{timesheet_id}	One timesheet with its break, comment and the shift it belongs to.
GET /leave-requests	Pending leave requests with employee, dates, leave type and comment.

Change the account. Calls marked Confirm wait for the user to approve them.

Deputy Endpoints: Write
Endpoint	Description
POST /locations/{location_id}/shifts Confirm	Add a shift to a location as a draft that only managers see.
POST /locations/{location_id}/shifts/publish Confirm	Publish the draft shifts of a location between two dates to the team.
POST /timesheets/{timesheet_id}/approve Confirm	Approve one pending timesheet.
POST /timesheets/{timesheet_id}/discard Confirm	Discard a timesheet for a shift that was not worked.
POST /leaves/{leave_id}/request/approve Confirm	Approve a pending leave request and set the hours of each day.
POST /leaves/{leave_id}/request/decline Confirm	Decline a pending leave request with a reason.