Events

/api/calendar/{calendarId}/events/{eventId}/updateThisAndFuture

Exposes stored calendar events and stages event changes until commit.

POST /api/calendar/{calendarId}/events/{eventId}/updateThisAndFuture

Splits a series before one occurrence and creates a new series master for that occurrence and all following occurrences.

Parameters

Name	Location	Type	Required	Description
`calendarId`	path	`string`	yes	—
`eventId`	path	`string`	yes	current internal event identifier

Request Body

Content Type	Schema	Required	Description
`application/json`	`OccurrenceUpdate`	yes	split identity and replacement values

Response

Status	Content Type	Schema	Description
`200`	`application/json`	`CalendarEventRead`	newly stored series master

Example Request

# Request
POST /api/calendar/<calendarId>/events/<eventId>/updateThisAndFuture HTTP/1.1
Accept: application/json
Authorization: Bearer <access-token>
Content-Type: application/json

{
    "summary": "string",
    "occurrenceStart": 0,
    "startTime": 0,
    "endTime": 0
}

# Response
HTTP/1.1 200 OK
Content-Type: application/json

{
    "attachments": [
        "string"
    ],
    "recurrence": "string",
    "id": "avdfszdee5aj2zykpd80t85vr",
    "masterId": "8k9yf76rb1ed9trovoayd2042",
    "recurrenceId": 0
}

Common Error Responses

The status codes 400, 403, 404, 405, 406, 409, 413, 415, and 500 use the same ApiError JSON error format:

{
    "status": 404,
    "code": "route_not_found",
    "message": "The requested API route does not exist.",
    "details": []
}

Schemas

Request and response schemas used on this page.

OccurrenceUpdate

Property	Type	Required	Description
`summary`	`string`	no	—
`occurrenceStart`	`number (int64)`	no	—
`startTime`	`number (int64)`	no	—
`endTime`	`number (int64)`	no	—

CalendarEventRead

Property	Type	Required	Description
`attachments`	`array<string>`	no	Returns attachment URLs without exposing internal attachment metadata.
`recurrence`	`EventRecurrence`	no	Optional recurrence rule and exception data.
`id`	`string`	no	Current internal event identifier.
`masterId`	`string`	no	Current series master identifier for an expanded occurrence.
`recurrenceId`	`number (int64)`	no	Original start of the replaced occurrence as Unix epoch milliseconds (RFC 5545 `RECURRENCE-ID`) if this stored event is an override of a single occurrence of the series with the same `uid`. Overrides are created with `updateOccurrence`.
`uid`	`string`	no	External iCalendar UID, which is not used for routing.
`summary`	`string`	no	Event title.
`description`	`string`	no	Optional event description.
`location`	`string`	no	Optional event location.
`startTime`	`number (int64)`	no	Start instant as Unix epoch milliseconds.
`endTime`	`number (int64)`	no	End instant as Unix epoch milliseconds.
`allDay`	`boolean`	no	Whether the event spans whole local calendar days.
`timezone`	`string`	no	IANA timezone used for local and recurring event semantics.
`attendees`	`array<Attendee>`	no	Event attendees and their response states.
`priority`	`integer (int32)`	no	Event priority from zero through nine.
`url`	`string`	no	Optional related URL.
`categories`	`array<string>`	no	Event category names.
`color`	`string`	no	Optional event-specific color.
`reminders`	`array<Reminder>`	no	Reminder alarms.
`transparent`	`boolean`	no	Whether the event is transparent for free/busy calculations.
`status`	`string [TENTATIVE, CONFIRMED, CANCELLED]`	no	Current iCalendar event status.
`sequence`	`integer (int32)`	no	Monotonic iCalendar sequence value.
`immutable`	`boolean`	no	Whether the provider marks the event as immutable.
`created`	`number (int64)`	no	Event creation time as Unix epoch milliseconds.
`lastModified`	`number (int64)`	no	Last modification time as Unix epoch milliseconds.
`attachmentEditingEnabled`	`boolean`	no	Whether the target provider supports changing attachment URLs.

EventRecurrence

Property	Type	Required	Description
`rrule`	`string`	no	—
`exdate`	`array<number (int64)>`	no	—
`rdate`	`array<number (int64)>`	no	—
`until`	`number (int64)`	no	—
`overridden`	`array<number (int64)>`	no	—

Attendee

Property	Type	Required	Description
`name`	`string`	no	—
`email`	`string`	no	—
`status`	`string [NONE, ACCEPTED, DECLINED, TENTATIVE]`	no	—

Reminder

Property	Type	Required	Description
`before`	`number (int64)`	no	—
`description`	`string`	no	—
`type`	`string [DISPLAY, EMAIL]`	no	—

ApiError

Property	Type	Required	Description
`status`	`integer (int32)`	yes	—
`code`	`string`	yes	—
`message`	`string`	yes	—
`details`	`array<object>`	no	—