Wispr AI Calendar API is one of 50 APIs that Wispr AI publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Calendar. The published artifact set on APIs.io includes an OpenAPI specification.
This API exposes
6 operations
across 6 paths,
and defines 11 schemas.
It is described by OpenAPI 3.0.3, at version 0.5.2.
Requests are made against the base URL https://api.wisprflow.ai.
6 operations6 paths11 schemas4 GET2 POST
Metadata
The identity and technical contract details declared by the specification.
Specification
OpenAPI 3.0.3
API Version
0.5.2
Base URL
https://api.wisprflow.ai
Authentication
API Key, API Key
Resource Areas
1
Authentication & Security 2
Wispr AI Calendar API declares
2 security schemes
for authenticating requests.
An API key is passed in the header as Authorization (ApiKeyHeaderPatched).
An API key is passed in the header as X-API-Key (APIKeyHeader).
Paths & Operations 6
Across 6 paths, the API surfaces 6 operations — 4 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.
Calendar 6
GET
/api/v1/calendar/events/batch
Get Events Batch
get_events_batch1 param→ 200422
GET
/api/v1/calendar/sync
Sync Calendar
sync_calendar3 params→ 200422
GET
/api/v1/calendar/prereads/agentic_sync
Sync Agentic Prereads
sync_agentic_prereads2 params→ 200422
GET
/api/v1/calendar/events/{external_id}/preread
Get Event Preread
get_event_preread3 params→ 200429422
POST
/api/v1/calendar/preread/feedback
Submit Event Preread Feedback
submit_event_preread_feedbackbody→ 204429422
POST
/api/v1/calendar/resync
Manual Resync
manual_resync→ 200
Schemas 11
The contract defines 11 schemas that model the data the API accepts and returns. The most detailed are CalendarEventDTO (11 properties), PrereadFeedbackRequest (6 properties), AgenticPrereadSyncItemDTO (5 properties), ValidationError (5 properties). Each schema is shown below with its type and property counts.
PrereadResponse
object
Response shape for GET /api/v1/calendar/events/{externalid}/preread. The endpoint generates the pre-read on-the-fly per request (no persistence), so generateda…
4 properties4 required
CalendarEventBatchResponse
object
Response shape for GET /api/v1/calendar/events/batch. Returns events matching the requested externalId values. Missing ids (not in the DB, or belonging to anot…
1 property1 required
AgenticPrereadSyncItemDTO
object
One agentic pre-read deliverable keyed by the calendar event's externalid.
5 properties5 required
AgenticPrereadSyncResponse
object
Response shape for GET /api/v1/calendar/prereads/agenticsync. Mirrors the calendar sync cursor contract: desktop advances since to serverTime once nextCursor i…
3 properties2 required
ParticipantDTO
object
Per-attendee detail for the desktop: display name, optional real profile photo, and self flag. Carried alongside the legacy participants: list[str] (display-na…
3 properties1 required
PrereadFeedbackRequest
object
Request shape for POST /api/v1/calendar/preread/feedback.
6 properties2 required
ValidationError
object
5 properties3 required
SyncResponse
object
Response shape for GET /api/v1/calendar/sync (Day 2). Defined now so the contract is locked. servertime is the timestamp at which the server produced the respo…
3 properties2 required
CalendarEventDTO
object
API contract for a calendar event mirrored from Google Calendar. Field aliases serialize to camelCase for the desktop client. populatebyname=True accepts both…
11 properties5 required
ResyncResponse
object
Response shape for POST /api/v1/calendar/resync. Returned by the manual-resync debug endpoint. eventscount is the number of calendarevent rows present for the…
2 properties2 required
HTTPValidationError
object
1 property
Specification
The full machine-readable OpenAPI contract behind this narrative.
