v1/shift_presets/{id}

put

https://shyftplan.com/api/v1/shift_presets/{id}

Update a shift preset.

Path Params

int32

required

≥ 1

Id of the shift preset

Body Params

Update a shift preset.

user_email

string

required

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

E-mail address of the API user.

authentication_token

string

required

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

Authentication token - can be fetched by login action.

company_id

int32

≥ 1

ID of a shyftplan account.

break_time

int32

≥ 1

Break duration in minutes

color

string

Color (HEX format, e.g. #FF00FF). Default colors are: #cddbfc, #bcc5d0, #ffd5f6, #e0eafc, #b6b7ba, #d8c7fc, #b8d0d9, #ebcefc, #ffdee9, #d4d9eb, #dbd8dc, #cddbb5, #f7dbad, #d3caba, #f8e6d1, #c4e0c8, #e2d6c9, #c2dcda, #f1ccb7, #e1bdbe

idempotency_key

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.

name

string

Name for the shift preset (max 256 characters)

short_name

string

ShortName for the shift preset (max 3 characters)

starts_at

date-time

Date-time (ISO 8601) for the begin of the object's span.

ends_at

date-time

Date-time (ISO 8601) for the end of the object's span.

tag_ids

array of objects

Filter for a list of tag IDs.

tag_ids

Responses

200Successfully updated

403forbidden

404Shift preset not found

422The request is invalid\n Incorrect tag context\n Invalid company_id\n Incorrect evaluation tag context\n Shift Tags feature is not enabled\n Shift preset cannot exceed more than 24 hours\n end_date cannot be before start_date