Create, Update & Delete

Create new events, modify existing ones, delete events, and respond to invitations.

POST/api/access/calendar/eventsBearer Token

Create Event

Creates a new calendar event.

Request Body

Field	Type	Required	Description
calendarId	long	Yes	Target calendar ID (from List Calendars)
summary	string	Yes	Event title (max 255 chars)
description	string	No	Event description (max 2000 chars)
location	string	No	Event location (max 255 chars)
from	DateTime	Yes	Start time (UTC)
to	DateTime	Yes	End time (UTC)
isAllDay	bool	No	All-day event flag (default: false)
attendees	string[]	No	List of attendee email addresses
recurrence	string[]	No	RFC 5545 RRULE recurrence patterns
eventType	string	No	Optional event type
sendNotifications	bool	No	Send invitation notifications (default: true)

{ 
  "calendarId": 123, 
  "summary": "Project Kickoff", 
  "description": "Initial planning meeting for Q2 project", 
  "location": "Room 101", 
  "from": "2026-02-10T09:00:00Z", 
  "to": "2026-02-10T10:00:00Z", 
  "isAllDay": false, 
  "attendees": ["user1@example.com", "user2@example.com"], 
  "recurrence": ["RRULE:FREQ=WEEKLY;COUNT=4"], 
  "sendNotifications": true 
}

Error Responses

Status	Code	Description
400	—	Validation error (missing required fields, invalid data)
403	ACCESS_DENIED	Token permissions insufficient
403	TOKEN_DENIED	Token-level restriction prevents access
403	TIMEFRAME_DENIED	Event falls outside allowed timeframe
404	CALENDAR_NOT_FOUND	Calendar not found

PATCH/api/access/calendar/events/{eventId}Bearer Token

Update Event

Updates an existing calendar event. This is a partial update — only provide the fields you want to change.

Request Body (all optional)

Field	Type	Description
summary	string	New title (max 255 chars)
description	string	New description (max 2000 chars)
location	string	New location (max 255 chars)
from	DateTime	New start time (UTC)
to	DateTime	New end time (UTC)
isAllDay	bool	All-day event flag
addAttendees	string[]	Email addresses to add as attendees
removeAttendees	string[]	Email addresses to remove from attendees
sendNotifications	bool	Send update notifications (default: true)

{ 
  "summary": "Updated Title", 
  "description": "Updated description", 
  "location": "New Location", 
  "from": "2026-02-10T10:00:00Z", 
  "to": "2026-02-10T11:00:00Z", 
  "addAttendees": ["new@example.com"], 
  "removeAttendees": ["old@example.com"], 
  "sendNotifications": true 
}

Note

Returns the full updated Event object on success. See the Event schema for all fields.

Error Responses

Status	Code	Description
400	—	Invalid request body, or eventId is not a valid UUID
403	ACCESS_DENIED	Token lacks edit permissions
403	TOKEN_DENIED	Token-level restriction
403	TIMEFRAME_DENIED	Event falls outside allowed timeframe
404	EVENT_NOT_FOUND	Event does not exist
404	CALENDAR_NOT_FOUND	Calendar not found

DELETE/api/access/calendar/events/{eventId}Bearer Token

Delete Event

Deletes a calendar event.

Parameters

Parameter	In	Type	Description
eventId	Path	string (UUID)	Public event ID
notifyAttendees	Query	bool	Send cancellation notifications (default: true)

Response 200 OK

{ 
  "success": true, 
  "message": "Event deleted" 
}

Error Responses

Status	Description
400	Invalid event ID format (not a valid UUID)
404	Event not found or deletion failed

POST/api/access/calendar/events/{eventId}/respondBearer Token

Respond to Event

Responds to an event invitation (accept, decline, or tentatively accept).

Request Body

Field	Type	Required	Description
status	string	Yes	Response status (see below)
comment	string	No	Optional comment with the response
sendNotification	bool	No	Send notification to organizer (default: true)

Valid Status Values

Value	Description
`accepted`	Accept the invitation
`declined`	Decline the invitation
`tentative`	Tentatively accept

{ 
  "status": "accepted", 
  "comment": "Looking forward to it!", 
  "sendNotification": true 
}

Note

Returns the full updated Event object on success. See the Event schema for all fields.

Error Responses

Status	Description
400	Invalid event ID format (not a valid UUID)
400	Invalid status value — must be one of: accepted, declined, tentative
404	Event not found or response failed