Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 7 additions & 3 deletions fern/apis/api/definition/inboxes/calendar.yml
Original file line number Diff line number Diff line change
Expand Up @@ -645,7 +645,7 @@ service:
every date that has not been edited individually.
- **Dated ID (`<uuid>_<slot>`):** changes one date (`mode=single`, the default) or that date
and every later date (`mode=future`). `all_day`, `timezone` and `recurrence` cannot be sent
for a dated ID.
for a dated ID. Including any of these fields returns `400`, even if the value is unchanged.

Once a date has started, its start can no longer change (409 `event_already_started`), but
its end and status can; for a one-off or series UUID, send the unchanged `start` with the new
Expand All @@ -671,7 +671,9 @@ service:
type: optional<string>
docs: The event's or date's current `etag`, from the latest read or write response. Optional; makes the update conditional; `*` matches any current version.
query-parameters:
mode: optional<calendar.InstanceMutationMode>
mode:
type: optional<calendar.InstanceMutationMode>
docs: For a dated ID, use `single` (default) for that occurrence or `future` for that occurrence and all later ones. Omit `mode` for a one-off or series UUID. Supplying it with a UUID returns `400`, even for `mode=single`.
body:
extends: calendar.UpdateCalendarEventRequest
properties: {}
Expand Down Expand Up @@ -840,7 +842,9 @@ service:
unique across your organization: reusing one to delete a different event returns
`409` `idempotency_conflict`.
query-parameters:
mode: optional<calendar.InstanceMutationMode>
mode:
type: optional<calendar.InstanceMutationMode>
docs: For a dated ID, use `single` (default) for that occurrence or `future` for that occurrence and all later ones. Omit `mode` for a one-off or series UUID. Supplying it with a UUID returns `400`, even for `mode=single`.
send_invites:
type: optional<boolean>
docs: When `true`, emails a cancellation (iCalendar `CANCEL`) to every attendee. Only the organizer can send. Defaults to `false`.
Expand Down
2 changes: 1 addition & 1 deletion fern/pages/calendar/invitations.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -146,7 +146,7 @@ Later emails from the organizer keep the event in sync:
- An updated invitation (`REQUEST`) updates the event, or one date of it.
- An updated invitation for one upcoming date of a recurring meeting the calendar doesn't have (the inbox was invited to that date alone, or the meeting's first invitation never reached the calendar) adds that date, as a recurring event with that one date. The organizer's next update to the whole meeting turns it into the full series.
- A cancellation (`CANCEL`) sets the event, or one date of it, to `cancelled`.
- Updates are ordered by iCalendar `SEQUENCE`, so an older update that arrives late does not overwrite a newer one. A change to one date is compared only with earlier changes to that same date.
- AgentMail applies a `REQUEST` or `CANCEL` when its `SEQUENCE` is higher than the last one applied, or when the sequence is equal and its `DTSTAMP` is later. For example, a rename with `SEQUENCE:0` can update an invitation that also had `SEQUENCE:0`. If both values match, AgentMail ignores the duplicate. A change to one date is compared only with earlier changes to that same date.

### Which invitations are accepted

Expand Down
Loading