# Contio MeetingOS User API

> Source: [OpenAPI spec](https://docs.contio.ai/user-api/openapi/) | [raw JSON](https://docs.contio.ai/user-api/agent/openapi.json) | [operations.json](https://docs.contio.ai/user-api/agent/operations.json) | [MCP manifest](https://docs.contio.ai/user-api/agent/mcp.json) | [admin MCP manifest](https://docs.contio.ai/user-api/agent/admin-mcp.json)

The Contio User/Workspace API is the first-party /v1 REST API for meetings, action items, agenda items, calendar, meeting context, participants, tokens, first-party OAuth, and workspace administration. This file indexes every operation for coding agents and LLM toolchains.

## Authentication Surfaces

- **user-oauth** (38 ops): ContioAuth bearer token; requires `Authorization` header.
- **admin** (12 ops): ContioAuth bearer token from a workspace admin/owner; requires `Authorization` header.
- **public** (3 ops): No authentication required.

Credentials: for quick ad hoc access, create a **short-lived access token** (`cto_slt_v1_`) from the Contio UI at **Settings > API Tokens**; it is available on all plans and expires within hours. For unattended automation, use a **Personal Access Token** (PRO and higher) or the **OAuth 2.1 + PKCE** flow.

## Operations

### Action Items

- **v1ListActionItems** `GET /v1/action-items` — List action items ([details](https://docs.contio.ai/user-api/agent/operations.json#v1ListActionItems)) [user-oauth]
- **v1CreateActionItem** `POST /v1/action-items` — Create action item ([details](https://docs.contio.ai/user-api/agent/operations.json#v1CreateActionItem)) [user-oauth]
- **v1GetActionItem** `GET /v1/action-items/{id}` — Get action item ([details](https://docs.contio.ai/user-api/agent/operations.json#v1GetActionItem)) [user-oauth]
- **v1UpdateActionItem** `PATCH /v1/action-items/{id}` — Update action item ([details](https://docs.contio.ai/user-api/agent/operations.json#v1UpdateActionItem)) [user-oauth]
- **v1DeleteActionItem** `DELETE /v1/action-items/{id}` — Delete action item ([details](https://docs.contio.ai/user-api/agent/operations.json#v1DeleteActionItem)) [user-oauth]

### Agenda Items

- **v1ListAgendaItems** `GET /v1/agenda-items` — List agenda items ([details](https://docs.contio.ai/user-api/agent/operations.json#v1ListAgendaItems)) [user-oauth]
- **v1CreateAgendaItem** `POST /v1/agenda-items` — Create an agenda item ([details](https://docs.contio.ai/user-api/agent/operations.json#v1CreateAgendaItem)) [user-oauth]
- **v1GetAgendaItem** `GET /v1/agenda-items/{id}` — Get an agenda item ([details](https://docs.contio.ai/user-api/agent/operations.json#v1GetAgendaItem)) [user-oauth]
- **v1UpdateAgendaItem** `PATCH /v1/agenda-items/{id}` — Update an agenda item ([details](https://docs.contio.ai/user-api/agent/operations.json#v1UpdateAgendaItem)) [user-oauth]
- **v1DeleteAgendaItem** `DELETE /v1/agenda-items/{id}` — Delete an agenda item ([details](https://docs.contio.ai/user-api/agent/operations.json#v1DeleteAgendaItem)) [user-oauth]

### Calendar

- **v1ListCalendarEvents** `GET /v1/calendar/events` — List calendar events ([details](https://docs.contio.ai/user-api/agent/operations.json#v1ListCalendarEvents)) [user-oauth]
- **v1GetCalendarEvent** `GET /v1/calendar/events/{id}` — Get calendar event by ID ([details](https://docs.contio.ai/user-api/agent/operations.json#v1GetCalendarEvent)) [user-oauth]

### First-Party OAuth

- **v1GetOAuthJwks** `GET /v1/oauth/.well-known/jwks.json` — First-Party JWKS ([details](https://docs.contio.ai/user-api/agent/operations.json#v1GetOAuthJwks)) [public]
- **v1GetOAuthOpenidConfiguration** `GET /v1/oauth/.well-known/openid-configuration` — First-Party OIDC Discovery ([details](https://docs.contio.ai/user-api/agent/operations.json#v1GetOAuthOpenidConfiguration)) [public]
- **v1AuthorizeOAuth** `GET /v1/oauth/authorize` — First-Party OAuth Authorization ([details](https://docs.contio.ai/user-api/agent/operations.json#v1AuthorizeOAuth)) [user-oauth]
- **v1RevokeOAuthToken** `POST /v1/oauth/revoke` — First-Party OAuth Token Revocation ([details](https://docs.contio.ai/user-api/agent/operations.json#v1RevokeOAuthToken)) [user-oauth]
- **v1ExchangeOAuthToken** `POST /v1/oauth/token` — First-Party OAuth Token Exchange ([details](https://docs.contio.ai/user-api/agent/operations.json#v1ExchangeOAuthToken)) [public]

### Meeting Context

- **v1ListMeetingContext** `GET /v1/meetings/{id}/context` — List meeting contexts ([details](https://docs.contio.ai/user-api/agent/operations.json#v1ListMeetingContext)) [user-oauth]
- **v1UploadMeetingContext** `POST /v1/meetings/{id}/context` — Upload meeting context ([details](https://docs.contio.ai/user-api/agent/operations.json#v1UploadMeetingContext)) [user-oauth]
- **v1GetMeetingContext** `GET /v1/meetings/{id}/context/{context_id}` — Get meeting context ([details](https://docs.contio.ai/user-api/agent/operations.json#v1GetMeetingContext)) [user-oauth]
- **v1DeleteMeetingContext** `DELETE /v1/meetings/{id}/context/{context_id}` — Delete meeting context ([details](https://docs.contio.ai/user-api/agent/operations.json#v1DeleteMeetingContext)) [user-oauth]
- **v1DownloadMeetingContextContent** `GET /v1/meetings/{id}/context/{context_id}/content` — Download meeting context content ([details](https://docs.contio.ai/user-api/agent/operations.json#v1DownloadMeetingContextContent)) [user-oauth]

### Meeting Templates

- **v1ListMeetingTemplates** `GET /v1/meeting-templates` — List meeting templates ([details](https://docs.contio.ai/user-api/agent/operations.json#v1ListMeetingTemplates)) [user-oauth]

### Meetings

- **v1ListMeetings** `GET /v1/meetings` — List meetings ([details](https://docs.contio.ai/user-api/agent/operations.json#v1ListMeetings)) [user-oauth]
- **v1CreateMeeting** `POST /v1/meetings` — Create a meeting ([details](https://docs.contio.ai/user-api/agent/operations.json#v1CreateMeeting)) [user-oauth]
- **v1SearchMeetings** `GET /v1/meetings/search` — Search meetings ([details](https://docs.contio.ai/user-api/agent/operations.json#v1SearchMeetings)) [user-oauth]
- **v1ListUpcomingMeetings** `GET /v1/meetings/upcoming` — List upcoming meetings ([details](https://docs.contio.ai/user-api/agent/operations.json#v1ListUpcomingMeetings)) [user-oauth]
- **v1GetMeeting** `GET /v1/meetings/{id}` — Get meeting by ID ([details](https://docs.contio.ai/user-api/agent/operations.json#v1GetMeeting)) [user-oauth]
- **v1UpdateMeeting** `PATCH /v1/meetings/{id}` — Update a meeting ([details](https://docs.contio.ai/user-api/agent/operations.json#v1UpdateMeeting)) [user-oauth]
- **v1DeleteMeeting** `DELETE /v1/meetings/{id}` — Delete a meeting ([details](https://docs.contio.ai/user-api/agent/operations.json#v1DeleteMeeting)) [user-oauth]
- **v1ExportTranscript** `GET /v1/meetings/{id}/transcript/export` — Export meeting transcript ([details](https://docs.contio.ai/user-api/agent/operations.json#v1ExportTranscript)) [user-oauth]

### Participants

- **v1ListMeetingContacts** `GET /v1/meetings/{id}/contacts` — List meeting contacts ([details](https://docs.contio.ai/user-api/agent/operations.json#v1ListMeetingContacts)) [user-oauth]
- **v1ListMeetingParticipants** `GET /v1/meetings/{id}/participants` — List meeting participants ([details](https://docs.contio.ai/user-api/agent/operations.json#v1ListMeetingParticipants)) [user-oauth]
- **v1AddMeetingParticipants** `POST /v1/meetings/{id}/participants` — Add meeting participants ([details](https://docs.contio.ai/user-api/agent/operations.json#v1AddMeetingParticipants)) [user-oauth]
- **v1RemoveMeetingParticipant** `DELETE /v1/meetings/{id}/participants/{userId}` — Remove meeting participant by user ID ([details](https://docs.contio.ai/user-api/agent/operations.json#v1RemoveMeetingParticipant)) [user-oauth]
- **v1UpdateMeetingParticipantRole** `PATCH /v1/meetings/{id}/participants/{userId}/role` — Update meeting participant role by user ID ([details](https://docs.contio.ai/user-api/agent/operations.json#v1UpdateMeetingParticipantRole)) [user-oauth]

### User Events

- **v1StreamUserEvents** `GET /v1/user/events` — Stream workspace events (SSE) ([details](https://docs.contio.ai/user-api/agent/operations.json#v1StreamUserEvents)) [user-oauth]

### User Profile

- **v1GetMe** `GET /v1/me` — Get current user identity ([details](https://docs.contio.ai/user-api/agent/operations.json#v1GetMe)) [user-oauth]

### User Tokens

- **v1GetAuthIntrospect** `GET /v1/auth/introspect` — Introspect first-party token ([details](https://docs.contio.ai/user-api/agent/operations.json#v1GetAuthIntrospect)) [user-oauth]
- **v1ListUserTokens** `GET /v1/user/tokens` — List user access tokens ([details](https://docs.contio.ai/user-api/agent/operations.json#v1ListUserTokens)) [user-oauth]
- **v1DeleteUserToken** `DELETE /v1/user/tokens/{id}` — Delete a user access token ([details](https://docs.contio.ai/user-api/agent/operations.json#v1DeleteUserToken)) [user-oauth]

### Workspace

- **v1GetWorkspace** `GET /v1/workspace` — Get workspace settings ([details](https://docs.contio.ai/user-api/agent/operations.json#v1GetWorkspace)) [admin]
- **v1UpdateWorkspace** `PATCH /v1/workspace` — Update workspace settings ([details](https://docs.contio.ai/user-api/agent/operations.json#v1UpdateWorkspace)) [admin]
- **v1ListWorkspaceMembers** `GET /v1/workspace/members` — List workspace members ([details](https://docs.contio.ai/user-api/agent/operations.json#v1ListWorkspaceMembers)) [admin]
- **v1UpdateWorkspaceMemberRole** `PATCH /v1/workspace/members/{userID}` — Update member role ([details](https://docs.contio.ai/user-api/agent/operations.json#v1UpdateWorkspaceMemberRole)) [admin]
- **v1RemoveWorkspaceMember** `DELETE /v1/workspace/members/{userID}` — Remove workspace member ([details](https://docs.contio.ai/user-api/agent/operations.json#v1RemoveWorkspaceMember)) [admin]

### Workspace API Keys

- **v1ListWorkspaceApiKeys** `GET /v1/workspace/api-keys` — List workspace API keys ([details](https://docs.contio.ai/user-api/agent/operations.json#v1ListWorkspaceApiKeys)) [admin]
- **v1DeleteWorkspaceApiKey** `DELETE /v1/workspace/api-keys/{id}` — Delete a workspace API key ([details](https://docs.contio.ai/user-api/agent/operations.json#v1DeleteWorkspaceApiKey)) [admin]

### Workspace Webhooks

- **v1ListWorkspaceWebhooks** `GET /v1/workspace/webhooks` — List workspace webhook endpoints ([details](https://docs.contio.ai/user-api/agent/operations.json#v1ListWorkspaceWebhooks)) [admin]
- **v1CreateWorkspaceWebhook** `POST /v1/workspace/webhooks` — Create a workspace webhook endpoint ([details](https://docs.contio.ai/user-api/agent/operations.json#v1CreateWorkspaceWebhook)) [admin]
- **v1DeleteWorkspaceWebhook** `DELETE /v1/workspace/webhooks/{id}` — Delete a workspace webhook endpoint ([details](https://docs.contio.ai/user-api/agent/operations.json#v1DeleteWorkspaceWebhook)) [admin]
- **v1ReEnableWorkspaceWebhook** `POST /v1/workspace/webhooks/{id}/re-enable` — Re-enable a disabled webhook endpoint ([details](https://docs.contio.ai/user-api/agent/operations.json#v1ReEnableWorkspaceWebhook)) [admin]
- **v1RotateWorkspaceWebhookSecret** `POST /v1/workspace/webhooks/{id}/rotate-secret` — Rotate webhook endpoint signing secret ([details](https://docs.contio.ai/user-api/agent/operations.json#v1RotateWorkspaceWebhookSecret)) [admin]