Calendar developer access

Agendas, events, availability, conflicts, recurrence, attendance responses, and expiring scheduling holds.

Owner: Vision Calendar
Lifecycle: preview
Runtime: restricted
App entitlement: calendar
Audience: vision-calendar
Workspace: Calendar workspace reference required

Authority boundary

Calendar owns scheduling resources, workspace and actor bindings, visibility, recurrence, conflict, and concurrency rules.

Complete preview contract: Every operation and MCP capability in the approved definitions below is documented. The lifecycle and runtime labels describe stability and availability, not partial catalog coverage.

Calendar API

Owning App: Calendar
Contract version: 1.20.0
Audience: vision-calendar
Workspace binding: Calendar workspace reference required

Download the authoritative OpenAPI 3.1 definition

46 operations

Generated from Vision Calendar API 1.20.0

GET/health/live
Process liveness
No bearer scope declared
Full operation reference →
GET/calendar/v1/meta
Version and contract metadata
No bearer scope declared
Full operation reference →
GET/calendar/v1/openapi.json
OpenAPI contract
No bearer scope declared
Full operation reference →
GET/calendar/v1/ready
Authenticated schema readiness
calendar:health:read
Full operation reference →
POST/calendar/v1/actor-bindings
Provision or reactivate a Vision human actor binding
calendar:actor:provision
Full operation reference →
GET/calendar/v1/agenda
Authorized, visibility-filtered agenda
calendar:agenda:read
Full operation reference →
GET/calendar/v1/contributions/agenda
Today feed: the caller's own events for their local day
calendar:agenda:read
Full operation reference →
GET/calendar/v1/events/{reference}
Authorized event details
calendar:event:read
Full operation reference →
GET/calendar/v1/availability/{actorReference}
Working hours, exceptions, and free/busy without event details
calendar:availability:read
Full operation reference →
POST/calendar/v1/conflicts
Find event and active-hold conflicts without record details
calendar:conflict:read
Full operation reference →
POST/calendar/v1/event-commands
Create, update, or cancel a locally authoritative event
calendar:event:write
Full operation reference →
POST/calendar/v1/attendance-commands
Record the authorized actor's response to an internal invitation
calendar:attendance:write
Full operation reference →
POST/calendar/v1/recurrence-commands
Modify or cancel one materialized occurrence in a local series
calendar:recurrence:write
Full operation reference →
POST/calendar/v1/hold-commands
Create or release an expiring scheduling hold
calendar:hold:write
Full operation reference →
POST/calendar/v1/availability/slots
Open bookable slots across one or more actors
calendar:availability:read
Full operation reference →
POST/calendar/v1/availability-commands
Set working hours, or create and delete availability exceptions
calendar:availability:write
Full operation reference →
GET/calendar/v1/presentation
Calendar's interface, described for this caller
calendar:agenda:read
Full operation reference →
GET/health/ready
Readiness — unauthenticated, and it touches the database
No bearer scope declared
Full operation reference →
GET/calendar/v1/collections
List the calendars the calling actor can reach
calendar:collection:read
Full operation reference →
POST/calendar/v1/collection-commands
Create, rename, recolor or archive a calendar; set the default write target or per-actor preferences
calendar:collection:write
Full operation reference →
GET/calendar/v1/eligible-people
Calendar's synchronized local actor directory
calendar:availability:read
Full operation reference →
GET/calendar/v1/provider-connections
Actor-owned provider connectivity state
calendar:provider:read
Full operation reference →
GET/calendar/v1/provider-connections/{provider}/calendars
Actor-owned discovered and mapped provider calendars
calendar:provider:read
Full operation reference →
POST/calendar/v1/request-call-commands
Hold, confirm, release, or cancel a Calendar-owned requested call
calendar:request_call:write
Full operation reference →
GET/calendar/v1/availability/me
The calling person's own working hours, exceptions, and free/busy
calendar:availability:read
Full operation reference →
GET/calendar/v1/sync/connections
The caller's connected Google, Microsoft and Zoom accounts
calendar:provider:read
Full operation reference →
POST/calendar/v1/sync/connection-commands
Connect, choose calendars, resync or disconnect an account
calendar:provider:write
Full operation reference →
GET/calendar/v1/sync/ics-subscriptions
The caller's subscribed iCal feeds
calendar:provider:read
Full operation reference →
POST/calendar/v1/sync/ics-subscription-commands
Subscribe to, refresh or remove an iCal feed counted as busy time
calendar:provider:write
Full operation reference →
GET/calendar/v1/sync/feeds
The caller's private published iCal feeds
calendar:provider:read
Full operation reference →
POST/calendar/v1/sync/feed-commands
Create, reset or revoke a private iCal feed link
calendar:provider:write
Full operation reference →
GET/calendar/v1/sync/conferencing
The caller's default meeting link and which options are usable now
calendar:provider:read
Full operation reference →
POST/calendar/v1/sync/conferencing-preference-commands
Set the caller's default meeting link
calendar:provider:write
Full operation reference →
POST/calendar/v1/sync/conferencing-commands
Attach or remove a meeting link on an event
calendar:conferencing:write
Full operation reference →
GET/calendar/v1/sync/conferences/{eventReference}
The live meeting link on an event
calendar:event:read
Full operation reference →
GET/calendar/v1/sync/oauth/start
Browser interstitial for connecting an account
No bearer scope declared
Full operation reference →
POST/calendar/v1/sync/oauth/start
Confirm connecting an account (the interstitial's form)
No bearer scope declared
Full operation reference →
GET/calendar/v1/sync/oauth/callback/{provider}
OAuth redirect URI
No bearer scope declared
Full operation reference →
POST/calendar/v1/sync/webhooks/google
Google Calendar push channel address
No bearer scope declared
Full operation reference →
POST/calendar/v1/sync/webhooks/microsoft
Microsoft Graph change-notification URL
No bearer scope declared
Full operation reference →
GET/calendar/v1/sync/feeds/{token}
A private iCal feed (subscribe from Apple Calendar, Google or Outlook)
No bearer scope declared
Full operation reference →
GET/calendar/v1/contributions/widgets
Today's widgets from Calendar
calendar:agenda:read
Full operation reference →
GET/calendar/v1/contributions/record-related
Meetings on another app's record
calendar:agenda:read
Full operation reference →
GET/apps/calendar/v1/people/contract
Read what Calendar says about someone leaving
No bearer scope declared
Full operation reference →
POST/calendar/v1/person-sharing-commands
Choose what colleagues see of your time
calendar:collection:write
Full operation reference →
POST/calendar/v1/people/agenda
Colleagues' time, as each of them shares it
calendar:availability:read
Full operation reference →

Vision Calendar MCP

MCPpreview

This is an authoritative capability inventory derived from Calendar's HTTP authority, not a reachable MCP transport. Any future MCP adapter must call the Calendar API without weakening actor binding, app entitlement, workspace isolation, operation scopes, record-version concurrency, or idempotency. Provider connection and external notification delivery remain unavailable.

Version: 1.0.1
Authority: calendar_http_contract_only
Transport: capability-inventory-only
Required scope: Operation-specific Calendar scope from the authoritative OpenAPI x-required-scope; write operations also require an Idempotency-Key

Approved capabilities

list_calendars
create_calendar
list_events
get_event
create_event
update_event
cancel_event
respond_to_invitation
find_available_slots
create_request_call_hold
confirm_request_call
release_request_call_hold
cancel_request_call_event
list_provider_connections

Explicitly prohibited

bypass_actor_binding
bypass_workspace_scope
bypass_operation_scope
replay_idempotency_key_with_different_body
claim_external_notification_delivery
connect_google_account
connect_microsoft_account
reveal_provider_tokens
issue_public_rsvp_link
run_sql

Download the authoritative MCP access definition

Publication evidence

This page is generated from the approval registry. Contract checksums, source drift, security declarations, scopes, references, and operation identifiers are verified before publication. A production documentation deployment remains a separate approval and rollback gate.