Update an event

put

https://integrate.rooflink.com/roof_link_endpoints/api/light/events/{id}/

Performs a full update of an event, replacing all fields with the provided values.

Permission Requirements:

The authenticated user must be an employee (crew members cannot update events).
The user must have edit permissions for the event.

Update Behavior:

All required fields must be provided (name, start, end).
The job field cannot be updated after creation (it is excluded from the update form).
Updating an event triggers calendar sync tasks for Google Calendar and Outlook.
Email and SMS notifications are sent to invitees if they have changed.

Validation Rules:

The start time must be before the end time.
Event duration must be at least 15 minutes.
Start times before 7 AM are adjusted to 7 AM (unless all_day or any_time is true).
End times before 8 AM are adjusted to 8 AM (unless all_day or any_time is true).
Invitees must be valid user IDs within the company.

Path Params

integer

required

The unique identifier of the event to update.

Body Params

Request body containing the complete event data for update. All required fields must be provided.

name

string

required

length between 1 and 1000

The name or title of the event.

description

string | null

Detailed description of the event.

start

date-time

required

Event start date and time in ISO 8601 format. Must be before the end time.

end

date-time

required

Event end date and time in ISO 8601 format. Must be after start time.

all_day

boolean

Defaults to false

Whether this is an all-day event.

any_time

boolean

Defaults to false

Whether this event can occur at any time.

invitees

array of integers | null

Array of user IDs to invite to the event. Replaces existing invitees.

invitees

200Event updated successfully. Returns the updated event object.

400Bad Request. The request body contains invalid data. This can occur if required fields are missing, field lengths exceed maximums, start time is after end time, or invitee IDs are invalid.

401Unauthorized. Authentication credentials were not provided or are invalid. The request must include a valid API key in the X-API-KEY header to access this endpoint.

403Forbidden. The authenticated user does not have the required permissions to update events. This endpoint is restricted to employees only. Crew members cannot update events.

404Not Found. The event with the specified ID does not exist, or belongs to a different company than the authenticated user.

429Too Many Requests. The client has exceeded the rate limit for this endpoint. Wait for the specified time period before making additional requests.

503Service Unavailable. The API rate limits for all public endpoints have been exceeded, or the service is temporarily down for maintenance. Try again later.