v1

latestOpenAPI 3.0.22026-07-24154101.1 MB

Schedule Events

Update Event

patch/v2/company/{company_id}/events/{event_id}

Path parameters

company_idinteger required

Company ID

event_idinteger required

Event ID

Headers

x-api-versionstring

An API version

Example:2022-05-01

7shifts API version

x-company-guidstring uuid

Company GUID

Request body

location_idsinteger[] required

The list of locations where this event occurs

start_datestring required

Start date

start_timestring required

Start time

end_datestring required

End date for multi-day events

end_timestring required

End time

titlestring required

The name of the event

descriptionstring nullable

Description for event

colorstring nullable

A hex number representing the color

is_multi_dayboolean required

If true, the event is a multi-day event

recurrencestring nullable

Recurrence rules as defined by the RFC 5545 spec

recurrence_target'THIS' | 'THIS_AND_FUTURE' nullable

describes which recurring events will be updated

Example request

{
  "start_date": "2019-01-01",
  "start_time": "09:00:00",
  "end_date": "2019-01-02",
  "end_time": "17:00:00",
  "color": "5ea17c",
  "recurrence": "Daily for 10 occurrences ==> (1997 9:00 AM EDT) September 2-11 DTSTART;TZID=America/New_York:19970902T090000 RRULE:FREQ=DAILY;COUNT=10"
}

Response

Example response

{
  "data": [
    {
      "start_date": "2019-01-01",
      "start_time": "09:00:00",
      "end_date": "2019-01-02",
      "end_time": "17:00:00",
      "color": "5ea17c",
      "recurrence": "Daily for 10 occurrences ==> (1997 9:00 AM EDT) September 2-11 DTSTART;TZID=America/New_York:19970902T090000 RRULE:FREQ=DAILY;COUNT=10"
    }
  ]
}