API Reference
Back to 7shifts.comBecome a Partner

Update Shift

put
https://api.7shifts.com/v2/company//shifts/
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Minimum Plan Required: The Works

Path Params
int64
required

Company ID

int64
required

Shift ID

Body Params
integer | null

Location ID

integer | null

User ID

integer | null

Department ID. Required if the location uses departments

integer | null

Role ID. Required if the location uses roles

integer | null

The station assigned to the shift

date-time | null

Start date time of the shift. UTC in ISO8601 format

date-time | null

End date time of the shift. UTC in ISO8601 format

boolean | null

Set to true if the shift ends at closing time. If set end is not used.

boolean | null

Set to true if the shift ends at business decline.

string | null

Notes displayed on a shift

boolean | null

If true the shift is not published.

boolean | null

Set to true if the shift is not assigned to any user. Open shifts can be requested by users.

integer | null
enum

Set when open is true. Set to 0 when everyone at a location can request an open shift; set to 1 if only offered to specified role.

Allowed:
boolean | null

When true the shift is unassigned. Internal use only.

integer | null
enum

The skill level required for this shift.

  • 1: Beginner
  • 2: Intermediate
  • 3: Experienced
Allowed:
integer | null
enum

Shift status type.

  • -1: Custom (requires custom_flag_id)
  • 0: None
  • 1: Sick
  • 2: No Show
  • 3: Late
  • 4: Call Out
  • 5: Left Late
Allowed:
integer | null

Custom shift flag ID. Required when status is -1. Must match a company custom shift flag.

integer | null

Number of minutes a user can clock in late after the shift starts.

breaks
array of objects or null | null

Breaks to be updated with the shift

breaks
Headers
string
^\d{4}-\d{2}-\d{2}$

7shifts API version

uuid

Company GUID

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated about 1 month ago

Did this page help you?
Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json

Updated about 1 month ago

Did this page help you?