Accept or decline emailed invitation
Files an emailed calendar invitation to the default calendar and submits the user's RSVP response (ACCEPT, DECLINE, TENTATIVE) to the organizer.
bearerAuthAuthorizationBearer <token>Two credential kinds share this scheme; GET /api/v1/auth/whoami answers which one you hold and what it reaches.
oek_… API key (minted by POST /api/v1/api-keys; shown once at mint). role: account reaches the full account surface: the directory (domains, routes, patterns, api-keys, accounts, address lists) plus every mailbox the account owns. role: system additionally reaches the operator surface, which is documented separately.
oemp_… mailbox app password (minted by POST /api/v1/identities/{identityId}/credentials). Reaches ONE mailbox: its messages, labels, threads, search, sync, send, filters and PIM collections. Directory routes refuse it with 403 insufficient_scope.
Refusal vocabulary: a missing, malformed, expired, or revoked credential answers 401 unauthorized with a WWW-Authenticate: Bearer challenge; a VALID credential outside its scope answers 403 (insufficient_scope for an app password on a directory route, system_credentials_required where only the operator may call). The public routes (health, branding, token-in-path capabilities) declare security: [].
identityId*stringIdentity ULID identifier
application/json- body
ics?stringInline form: the raw text/calendar part from the message
1 <= length <= 262144messageId?stringReference form: a message in THIS mailbox carrying the invitation
1 <= length <= 64partstat*stringRFC 5545 PARTSTAT to record for the caller
"ACCEPTED""DECLINED""TENTATIVE""NEEDS-ACTION"section?stringReference form, optional: the part's section as reported by …/messages/{id}/invitation. Omitted, the server picks the message's scheduling part itself
^[0-9]+(\.[0-9]+)*$length <= 64Recorded. filed says whether a copy had to be created; organizerUpdated / replySent report how the organizer was told, exactly as the collection-scoped RSVP does
application/json- response
calendarId*stringCalendar collection ULID holding the event
etag*stringUpdated ETag of the calendar object
filed*booleanTrue if the event was newly added to the calendar
href*stringDAV resource path of the event
myAddress*stringRecipient email address for which this RSVP was recorded
organizerUpdated*booleanTrue if local organizer event copy was updated directly
partstat*stringRecorded participation status (ACCEPTED, DECLINED, TENTATIVE)
"ACCEPTED""DECLINED""TENTATIVE""NEEDS-ACTION"replySent*booleanTrue if email reply was sent to remote organizer
summary*|Event title/summary, or null
curl -X POST 'https://api.open.email/api/v1/identities/string/calendars/invitations/respond' \
-H 'Content-Type: application/json' \
-d '{
"partstat": "ACCEPTED"
}'{
"calendarId": "string",
"etag": "string",
"filed": true,
"href": "string",
"myAddress": "string",
"organizerUpdated": true,
"partstat": "ACCEPTED",
"replySent": true,
"summary": "string"
}Check invitation status by UID GET
Checks whether an event with a specific iCalendar UID is already filed across any of the mailbox's calendars and returns the user's current RSVP response.
Get invitation from email message GET
Extracts and parses the iCalendar (.ics) meeting invitation from an email message with filing status and RSVP options.