# Deputy Shifts API

**Canonical:** https://apis.io/apis/deputy/deputy-shifts-api/  
**Provider:** Deputy — https://apis.io/providers/deputy/  
**Base URL:** https://{install}.{geo}.deputy.com/api/v1  
**Documentation:** https://developer.deputy.com/deputy-docs

Deputy Shifts API is one of 217 APIs that [Deputy](https://apis.io/providers/deputy/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 28 JSON Schema definitions. Tagged areas include Shifts. The published artifact set on APIs.io includes an OpenAPI specification and 28 JSON Schemas.

The Shifts API from Deputy — 34 operation(s) for shifts.

## Operations (37)

| Method | Path | Summary |
|---|---|---|
| GET | `/management/v2/shifts` | Retrieve list of shifts |
| POST | `/management/v2/shifts` | Create a new shift |
| POST | `/management/v2/shifts/bids:status` | decline a shift |
| GET | `/management/v2/shifts/copy/job/{jobId}` | Get copy status |
| POST | `/management/v2/shifts/open/pending-approvals` | Get pending approval open shifts |
| GET | `/management/v2/shifts/{id}` | Retrieve shift data by given Id |
| DELETE | `/management/v2/shifts/{id}` | Delete an existing shift |
| PUT | `/management/v2/shifts/{id}` | Update an existing shift |
| GET | `/management/v2/shifts/{id}/bids:statusCounts` | get the bid count for each status |
| GET | `/management/v2/shifts/{id}/history` | Get shift history |
| GET | `/management/v2/shifts/{id}/log` | Get shift log new |
| POST | `/management/v2/shifts/{id}/open:deleteInvitations` | delete open shift invitations |
| GET | `/management/v2/shifts/{id}/open:invitations` | get open shift invitation list |
| POST | `/management/v2/shifts/{id}/open:status` | Accept/decline an open shift |
| GET | `/management/v2/shifts/{id}/open:statusCounts` | get count for each status in find replacement, open shift |
| GET | `/management/v2/shifts/{id}/permissions` | Get shift permissions |
| POST | `/management/v2/shifts/{id}/suggestions` | Get suggestions for a shift |
| POST | `/management/v2/shifts/{id}:calculateCost` | Get potential costs for a shift given a list of employee ids |
| GET | `/management/v2/shifts:aggregated` | Retrieve an aggregated list of shifts |
| POST | `/management/v2/shifts:autobuild` | Auto-build shifts (Asynchronous) |
| POST | `/management/v2/shifts:autofill` | Auto-fill shifts (Asynchronous) |
| POST | `/management/v2/shifts:bulk` | Bulk create or update shifts (asynchronous) |
| POST | `/management/v2/shifts:bulkDefaults` | Get default shifts for many dates and areas |
| POST | `/management/v2/shifts:bulkDelete` | Bulk delete shifts (asynchronous) |
| POST | `/management/v2/shifts:bulkPatch` | Bulk patch shifts (asynchronous) |
| POST | `/management/v2/shifts:bulkUpdate` | Bulk update shifts (asynchronous) |
| POST | `/management/v2/shifts:copy` | Copy shifts (asynchronous) |
| POST | `/management/v2/shifts:defaults` | Get default shifts |
| POST | `/management/v2/shifts:delete` | Delete shift |
| POST | `/management/v2/shifts:getRosters` | manager to get rosters; replacement of v1 getRosters |
| POST | `/management/v2/shifts:link` | Link shifts |
| POST | `/management/v2/shifts:open` | Get open shifts |
| POST | `/management/v2/shifts:publish` | Publish shifts (asynchronous) |
| POST | `/management/v2/shifts:resave` | Resave shifts (Asynchronous) |
| POST | `/management/v2/shifts:split` | Split |
| POST | `/management/v2/shifts:validate` | Validate external shifts |
| POST | `/schedule/v2/me/shifts:search` | My schedule |

## Machine-readable artifacts (29)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/openapi/deputy-shifts-api-openapi.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-addanemployee-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-createa-department-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-addleaveforaemployee-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-createamemo-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-add-new-workplace-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-setawardforemployee-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-custom-field-data-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-timesheet-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-employee-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-pay-rules-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-roster-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-employee-agreement-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-tenanttimesheetv2model-timesheet-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-pay-comparison-submit-report-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-v2model-leave-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-v2model-employment-contracts-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-copy-request-copy-request-data-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-v2model-area-profile-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-searchfor-employment-contract-leave-rules-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-searchforan-employee-agreement-history-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-searchforan-employee-availability-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-searchforacustomfielddataentry-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-searchforan-employment-condition-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-searchforan-employment-contract-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-hr-export-export-hr-bulk-data-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-user-info-get-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-hr-export-export-hr-data-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deputy/refs/heads/main/json-schema/deputy-hr-export-export-hr-pay-details-data-response-schema.json

## Other Deputy APIs (12)

- [Deputy Public API](https://apis.io/apis/deputy/public-api/)
- [Deputy Access Management Employee API](https://apis.io/apis/deputy/deputy-access-management-employee-api/)
- [Deputy Access Management Employee Role API](https://apis.io/apis/deputy/deputy-access-management-employee-role-api/)
- [Deputy Access Management Employee Role History API](https://apis.io/apis/deputy/deputy-access-management-employee-role-history-api/)
- [Deputy Access Management Privilege Hierarchy API](https://apis.io/apis/deputy/deputy-access-management-privilege-hierarchy-api/)
- [Deputy Access Management Role API](https://apis.io/apis/deputy/deputy-access-management-role-api/)
- [Deputy Account Stats API](https://apis.io/apis/deputy/deputy-account-stats-api/)
- [Deputy Add Entitlement To Employees API](https://apis.io/apis/deputy/deputy-add-entitlement-to-employees-api/)
- [Deputy Address API](https://apis.io/apis/deputy/deputy-address-api/)
- [Deputy Agreed Hour API](https://apis.io/apis/deputy/deputy-agreed-hour-api/)
- [Deputy AI Assistant API](https://apis.io/apis/deputy/deputy-ai-assistant-api/)
- [Deputy Area Management API](https://apis.io/apis/deputy/deputy-area-management-api/)

## Tags

Shifts

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/deputy/deputy-shifts-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/deputy/.