Update Calendar Event Relevance
PATCH
/users/{user_id}/calendar/events/{event_id}
const url = 'https://example.com/users/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/calendar/events/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';const options = { method: 'PATCH', headers: {'Content-Type': 'application/json'}, body: '{"user_relevance":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PATCH \ --url https://example.com/users/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/calendar/events/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \ --header 'Content-Type: application/json' \ --data '{ "user_relevance": "example" }'Set (or clear) a user’s relevance override for one calendar event.
Lives in its own column, untouched by the ingest upsert, so a client re-sync never clobbers the mark. Recomputes the event’s local day summary so meeting counts reflect the change immediately (create_events=False — this is a recompute, not the nightly job).
Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”user_id
required
User Id
string format: uuid
event_id
required
Event Id
string format: uuid
Request Bodyrequired
Section titled “Request Bodyrequired”Responses
Section titled “Responses”Successful Response
Media typeapplication/json
CalendarEventRead
object
created_at
required
Created At
string format: date-time
ends_at
required
Ends At
string format: date-time
external_id
required
External Id
string
id
required
Id
string format: uuid
is_all_day
required
Is All Day
boolean
starts_at
required
Starts At
string format: date-time
status
required
Status
string
updated_at
required
Updated At
string format: date-time
user_id
required
User Id
string format: uuid
Examplegenerated
{ "attendee_count": 1, "calendar_id": "example", "calendar_name": "example", "created_at": "2026-04-15T12:00:00Z", "ends_at": "2026-04-15T12:00:00Z", "external_id": "example", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "is_all_day": true, "rsvp_status": "example", "starts_at": "2026-04-15T12:00:00Z", "status": "example", "title": "example", "updated_at": "2026-04-15T12:00:00Z", "user_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "user_relevance": "example"}Validation Error
Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationErrorobject
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{ "detail": [ { "loc": [ "example" ], "msg": "example", "type": "example" } ]}