v1/staff_shifts

Create a new StaffShift.

Body Params
string
required

This is a testing sandbox. We advise against using credentials for production accounts here.

E-mail address of the API user.

string
required

This is a testing sandbox. We advise against using credentials for production accounts here.

Authentication token - can be fetched by login action.

int32
required
≥ 1

ID of a shyftplan account.

boolean
Defaults to false

Assign to other connected shifts

int32
required

ID of an Employment

string

Optional MCP-safety idempotency key. When present with API-token auth, repeated calls with the same fingerprint within the TTL window replay the cached response instead of re-creating the shift preset. Ignored for session auth.

string
Defaults to false

Either true to ignore all conflicts listed below or an Array of specific conflicts to ignore. Only warnings can be ignored, enforced conflicts will persist. Possible values are:

  • shifts_collision
  • absences_collision
  • locations_position_changed
  • minimum_break
  • maximum_working_hours
  • minimum_rest
  • maximum_earning
  • outside_employment_period
  • maximum_consecutive_working_days
  • restricted_shift_presets
  • unavailable
  • not_available
  • minimum_qualification_level
  • not_in_shift_preset
  • punch_timing_reassignment

json

Metadata in JSON format.

int32
required

ID of the shift.

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json