API Reference The Contio MeetingOS User API is a REST API served under the /v1 path prefix on https://api.contio.ai. This page is a catalog of the available resources; the full, authoritative request/response schemas live in the interactive OpenAPI reference , which is generated directly from the /v1 controllers .
Authentication All resource endpoints require a first-party bearer token in the Authorization header:
Authorization: Bearer <cto_pat_v1_... | cto_at_v1_... | cto_wk_v1_...>
Obtain one via the OAuth 2.1 + PKCE flow , by issuing a Personal Access Token , or — for shared team automation acting as the workspace — a Workspace API key .
Scopes Scope Grants meetings:readRead meetings, agenda items, and context meetings:writeCreate, update, and delete meetings, agenda items, and context action-items:readRead action items action-items:writeCreate, update, and delete action items calendar:readRead calendar events workspace:readRead workspace settings, members, API keys, and webhooks workspace:writeManage workspace settings, members, API keys, and webhooks
Resource catalog First-Party OAuth Method Endpoint Description GET/v1/oauth/authorizeStart the OAuth 2.1 + PKCE authorization-code flow POST/v1/oauth/tokenExchange an authorization code, or refresh, for tokens POST/v1/oauth/revokeRevoke an access or refresh token (RFC 7009) GET/v1/oauth/.well-known/openid-configurationOIDC discovery document GET/v1/oauth/.well-known/jwks.jsonJSON Web Key Set for token verification
User Tokens Method Endpoint Description GET/v1/user/tokensList your personal access tokens POST/v1/user/tokensIssue a new personal access token DELETE/v1/user/tokens/{id}Delete a personal access token GET/v1/user/eventsStream workspace events over Server-Sent Events (text/event-stream); supply Last-Event-ID to resume
Meetings Method Endpoint Description GET/v1/meetingsList meetings POST/v1/meetingsCreate a meeting GET/v1/meetings/{id}Get a meeting DELETE/v1/meetings/{id}Delete a meeting GET/v1/meetings/{id}/participantsList participants POST/v1/meetings/{id}/participantsAdd a participant DELETE/v1/meetings/{id}/participants/{userId}Remove a participant GET/v1/meetings/{id}/contextList meeting context POST/v1/meetings/{id}/contextAttach meeting context GET/v1/meetings/{id}/context/{context_id}Get a context item DELETE/v1/meetings/{id}/context/{context_id}Delete a context item GET/v1/meetings/{id}/context/{context_id}/contentGet context content
Agenda Items Method Endpoint Description GET/v1/agenda-itemsList agenda items POST/v1/agenda-itemsCreate an agenda item PATCH/v1/agenda-items/{id}Update an agenda item DELETE/v1/agenda-items/{id}Delete an agenda item
Action Items Method Endpoint Description GET/v1/action-itemsList action items POST/v1/action-itemsCreate an action item PATCH/v1/action-items/{id}Update an action item DELETE/v1/action-items/{id}Delete an action item
Calendar Method Endpoint Description GET/v1/calendar/eventsList synced calendar events GET/v1/calendar/events/{id}Get calendar event details
Workspace Method Endpoint Description GET/v1/workspaceGet workspace settings PATCH/v1/workspaceUpdate workspace settings GET/v1/workspace/membersList workspace members PATCH/v1/workspace/members/{userID}Update a member's role DELETE/v1/workspace/members/{userID}Remove a member GET/v1/workspace/api-keysList workspace API keys DELETE/v1/workspace/api-keys/{id}Delete a workspace API key GET/v1/workspace/webhooksList workspace webhooks POST/v1/workspace/webhooksCreate a workspace webhook DELETE/v1/workspace/webhooks/{id}Delete a workspace webhook POST/v1/workspace/webhooks/{id}/re-enableRe-enable a disabled webhook POST/v1/workspace/webhooks/{id}/rotate-secretRotate a webhook signing secret
The OpenAPI spec is the source of truth
This catalog is a convenience overview. For exact parameters, request bodies, response schemas, and status codes, always consult the interactive OpenAPI reference , which is regenerated from the /v1 controllers on every release.