# Connvo API Documentation ## Docs - [deleteInsights](https://docs.connvo.app/api-reference/insights/deleteinsights.md): Calls a mutation at the path insights/index.js:deleteInsights - [deleteInsights](https://docs.connvo.app/api-reference/insights/deleteinsights-1.md): Calls a mutation at the path insights/mutations.js:deleteInsights - [generateInsights](https://docs.connvo.app/api-reference/insights/generateinsights.md): Calls a action at the path insights/generation.js:generateInsights - [generateInsights](https://docs.connvo.app/api-reference/insights/generateinsights-1.md): Calls a action at the path insights/index.js:generateInsights - [getConnectionRecommendations](https://docs.connvo.app/api-reference/insights/getconnectionrecommendations.md): Calls a query at the path insights/index.js:getConnectionRecommendations - [getConnectionRecommendations](https://docs.connvo.app/api-reference/insights/getconnectionrecommendations-1.md): Calls a query at the path insights/queries.js:getConnectionRecommendations - [getEmbeddingAnalytics](https://docs.connvo.app/api-reference/insights/getembeddinganalytics.md): Calls a query at the path embeddings/index.js:getEmbeddingAnalytics - [getEmbeddingAnalytics](https://docs.connvo.app/api-reference/insights/getembeddinganalytics-1.md): Get embedding analytics (public) - [getGlobalMatchingAnalytics](https://docs.connvo.app/api-reference/insights/getglobalmatchinganalytics.md): Get global matching analytics (admin only) - [getGlobalMatchingAnalytics](https://docs.connvo.app/api-reference/insights/getglobalmatchinganalytics-1.md): Calls a query at the path matching/index.js:getGlobalMatchingAnalytics - [getInsightById](https://docs.connvo.app/api-reference/insights/getinsightbyid.md): Calls a query at the path insights/index.js:getInsightById - [getInsightById](https://docs.connvo.app/api-reference/insights/getinsightbyid-1.md): Calls a query at the path insights/queries.js:getInsightById - [getMatchHistory](https://docs.connvo.app/api-reference/insights/getmatchhistory.md): Get match history for a user - [getMatchingStats](https://docs.connvo.app/api-reference/insights/getmatchingstats.md): Get matching statistics for a user - [optimizeMatchingWeights](https://docs.connvo.app/api-reference/insights/optimizematchingweights.md): Optimize matching weights based on feedback - [submitMatchFeedback](https://docs.connvo.app/api-reference/insights/submitmatchfeedback.md): Submit feedback for a match - [updateInsightsFeedback](https://docs.connvo.app/api-reference/insights/updateinsightsfeedback.md): Calls a mutation at the path insights/index.js:updateInsightsFeedback - [updateInsightsFeedback](https://docs.connvo.app/api-reference/insights/updateinsightsfeedback-1.md): Calls a mutation at the path insights/mutations.js:updateInsightsFeedback - [Convex HTTP API Primer](https://docs.connvo.app/api-reference/introduction.md): Learn how Convex translates functions into REST endpoints and how to read Connvo responses. - [addMultipleParticipants](https://docs.connvo.app/api-reference/meetings/addmultipleparticipants.md): Only the meeting host can add participants. Validates each user and skips those who are already participants or don't exist. Returns lists of successfully added participants and skipped entries with reasons. Updates the meeting's participant count automatically. - [addParticipant](https://docs.connvo.app/api-reference/meetings/addparticipant.md): Only the meeting host can add participants. Validates that the user exists and is not already a participant. Cannot add participants to concluded or cancelled meetings. Updates the meeting's participant count automatically. - [cancelMeeting](https://docs.connvo.app/api-reference/meetings/cancelmeeting.md): host can cancel meetings. Cannot cancel active meetings (must end them instead). Cannot cancel meetings that are already concluded or cancelled. - [closeSession](https://docs.connvo.app/api-reference/meetings/closesession.md): Calls a mutation at the path meetings/webrtc/index.js:closeSession - [closeSession](https://docs.connvo.app/api-reference/meetings/closesession-1.md): Closes a WebRTC session - [createMeeting](https://docs.connvo.app/api-reference/meetings/createmeeting.md): Creates a new meeting with comprehensive setup and hybrid video provider support. - [createWebRTCSession](https://docs.connvo.app/api-reference/meetings/createwebrtcsession.md): Calls a mutation at the path meetings/webrtc/index.js:createWebRTCSession - [createWebRTCSession](https://docs.connvo.app/api-reference/meetings/createwebrtcsession-1.md): Creates a WebRTC session for a meeting - [endMeeting](https://docs.connvo.app/api-reference/meetings/endmeeting.md): processing. Only the meeting host can end meetings. Calculates meeting duration and schedules cleanup tasks including insights generation, recording processing, and resource cleanup. Can only end meetings that are currently active. - [exchangeICECandidate](https://docs.connvo.app/api-reference/meetings/exchangeicecandidate.md): Calls a mutation at the path meetings/webrtc/index.js:exchangeICECandidate - [exchangeICECandidate](https://docs.connvo.app/api-reference/meetings/exchangeicecandidate-1.md): Exchanges ICE candidates for WebRTC connection establishment - [exchangeSessionDescription](https://docs.connvo.app/api-reference/meetings/exchangesessiondescription.md): Calls a mutation at the path meetings/webrtc/index.js:exchangeSessionDescription - [exchangeSessionDescription](https://docs.connvo.app/api-reference/meetings/exchangesessiondescription-1.md): Exchanges SDP offer/answer for WebRTC negotiation - [generateParticipantAccessToken](https://docs.connvo.app/api-reference/meetings/generateparticipantaccesstoken.md): Calls a action at the path meetings/webrtc/index.js:generateParticipantAccessToken - [generateParticipantAccessToken](https://docs.connvo.app/api-reference/meetings/generateparticipantaccesstoken-1.md): Calls a action at the path meetings/webrtc/rooms.js:generateParticipantAccessToken - [generateParticipantTokenPublic](https://docs.connvo.app/api-reference/meetings/generateparticipanttokenpublic.md): authenticated user to join a paid tier meeting. Resolves the user's identity, generates a token with appropriate permissions, and returns user details for the GetStream client. Tokens expire after 1 hour for security. - [getActiveSessions](https://docs.connvo.app/api-reference/meetings/getactivesessions.md): Calls a query at the path meetings/webrtc/index.js:getActiveSessions - [getActiveSessions](https://docs.connvo.app/api-reference/meetings/getactivesessions-1.md): Gets active WebRTC sessions for a meeting - [getMeeting](https://docs.connvo.app/api-reference/meetings/getmeeting.md): Provides aggregated session metrics and the caller's presence/role snapshot. - [getMeetingConnectionInfo](https://docs.connvo.app/api-reference/meetings/getmeetingconnectioninfo.md): Provides different information based on video provider: ICE servers for WebRTC or GetStream room ID for paid tier. Includes feature flags for recording, transcription, and participant limits. Only available for active meetings. - [getMeetingInsights](https://docs.connvo.app/api-reference/meetings/getmeetinginsights.md): Calls a query at the path insights/index.js:getMeetingInsights - [getMeetingInsights](https://docs.connvo.app/api-reference/meetings/getmeetinginsights-1.md): Calls a query at the path insights/queries.js:getMeetingInsights - [getPendingSignals](https://docs.connvo.app/api-reference/meetings/getpendingsignals.md): Calls a query at the path meetings/webrtc/index.js:getPendingSignals - [getPendingSignals](https://docs.connvo.app/api-reference/meetings/getpendingsignals-1.md): Gets pending WebRTC signals for a user in a meeting - [handleConnectionFailure](https://docs.connvo.app/api-reference/meetings/handleconnectionfailure.md): Calls a action at the path meetings/webrtc/index.js:handleConnectionFailure - [handleConnectionFailure](https://docs.connvo.app/api-reference/meetings/handleconnectionfailure-1.md): Handles WebRTC connection failures with automatic fallback - [initializeWebRTCRoom](https://docs.connvo.app/api-reference/meetings/initializewebrtcroom.md): Calls a action at the path meetings/webrtc/index.js:initializeWebRTCRoom - [initializeWebRTCRoom](https://docs.connvo.app/api-reference/meetings/initializewebrtcroom-1.md): Initializes WebRTC room for a meeting using the provider abstraction - [joinMeeting](https://docs.connvo.app/api-reference/meetings/joinmeeting.md): the meeting. Records the join timestamp. Only available for active meetings. Participants must be invited to the meeting before joining. - [leaveMeeting](https://docs.connvo.app/api-reference/meetings/leavemeeting.md): the meeting. Records the leave timestamp. Does not remove the participant from the meeting - they can rejoin if the meeting is still active. - [listMeetingParticipants](https://docs.connvo.app/api-reference/meetings/listmeetingparticipants.md): and real-time WebRTC connection status. Requires the caller to be a participant in the meeting. Includes WebRTC session count and connection state for each participant. - [markSignalsProcessed](https://docs.connvo.app/api-reference/meetings/marksignalsprocessed.md): Calls a mutation at the path meetings/webrtc/index.js:markSignalsProcessed - [markSignalsProcessed](https://docs.connvo.app/api-reference/meetings/marksignalsprocessed-1.md): Marks WebRTC signals as processed - [monitorConnectionQuality](https://docs.connvo.app/api-reference/meetings/monitorconnectionquality.md): Calls a action at the path meetings/webrtc/index.js:monitorConnectionQuality - [monitorConnectionQuality](https://docs.connvo.app/api-reference/meetings/monitorconnectionquality-1.md): Monitors WebRTC connection quality and provides recommendations - [recordActivity](https://docs.connvo.app/api-reference/meetings/recordactivity.md): Records activity to reset lull detection - [removeParticipant](https://docs.connvo.app/api-reference/meetings/removeparticipant.md): can remove participants. Cannot remove the only host from a meeting. Updates the meeting's participant count automatically. - [startMeeting](https://docs.connvo.app/api-reference/meetings/startmeeting.md): infrastructure. Supports hybrid architecture: WebRTC for free tier (up to 4 participants) and GetStream for paid tier (up to 100 participants with recording). Only the meeting host can start meetings. Provides ICE server configuration for WebRTC or schedules GetStream room creation. Automatically in… - [startRecording](https://docs.connvo.app/api-reference/meetings/startrecording.md): layout, and audio settings. Only available for paid tier meetings using GetStream. Only the meeting host can start recording. Includes rate limiting (max 3 starts per minute) and tracks recording metadata. Updates meeting state to reflect active recording. Includes circuit breaker and retry logic fo… - [stopRecording](https://docs.connvo.app/api-reference/meetings/stoprecording.md): recording URL and metadata. Only the meeting host can stop recording. Includes rate limiting (max 5 stops per minute) and tracks recording duration. Updates meeting state to reflect stopped recording. Includes circuit breaker and retry logic for resilience. - [subscribeMeetingNotes](https://docs.connvo.app/api-reference/meetings/subscribemeetingnotes.md): Real-time meeting notes subscription with permission validation and bandwidth management - [subscribeMeetingParticipants](https://docs.connvo.app/api-reference/meetings/subscribemeetingparticipants.md): Real-time meeting participants subscription - [updateCurrentTopics](https://docs.connvo.app/api-reference/meetings/updatecurrenttopics.md): Updates current topics being discussed - [updateParticipantRole](https://docs.connvo.app/api-reference/meetings/updateparticipantrole.md): Only the meeting host can update roles. Cannot demote the only host to participant. Useful for promoting participants to co-hosts or demoting hosts. - [updateSessionState](https://docs.connvo.app/api-reference/meetings/updatesessionstate.md): Calls a mutation at the path meetings/webrtc/index.js:updateSessionState - [updateSessionState](https://docs.connvo.app/api-reference/meetings/updatesessionstate-1.md): Updates WebRTC session state - [updateSpeakingStats](https://docs.connvo.app/api-reference/meetings/updatespeakingstats.md): Updates speaking statistics for a meeting - [applyNoteOperation](https://docs.connvo.app/api-reference/notes/applynoteoperation.md): Calls a mutation at the path notes/index.js:applyNoteOperation - [applyNoteOperation](https://docs.connvo.app/api-reference/notes/applynoteoperation-1.md): to resolve conflicts with concurrent edits. The operation is transformed against any concurrent operations that occurred after the client's last known state, ensuring convergence across all clients. Tracks conflicts and returns the transformed operation along with the new document version. - [batchApplyNoteOperation](https://docs.connvo.app/api-reference/notes/batchapplynoteoperation.md): Batched note operation processing with operational transform - [batchApplyNoteOperations](https://docs.connvo.app/api-reference/notes/batchapplynoteoperations.md): Calls a mutation at the path notes/index.js:batchApplyNoteOperations - [batchApplyNoteOperations](https://docs.connvo.app/api-reference/notes/batchapplynoteoperations-1.md): them sequentially within a single transaction. Each operation is transformed against concurrent operations from other clients, ensuring consistency. This is more efficient than individual operations for bulk edits like paste operations or undo/redo sequences. Returns detailed results for each operat… - [clearSyncedOperations](https://docs.connvo.app/api-reference/notes/clearsyncedoperations.md): Calls a mutation at the path notes/index.js:clearSyncedOperations - [clearSyncedOperations](https://docs.connvo.app/api-reference/notes/clearsyncedoperations-1.md): Clears synced operations from the offline queue - [createOfflineCheckpoint](https://docs.connvo.app/api-reference/notes/createofflinecheckpoint.md): Calls a mutation at the path notes/index.js:createOfflineCheckpoint - [createOfflineCheckpoint](https://docs.connvo.app/api-reference/notes/createofflinecheckpoint-1.md): Creates a checkpoint for offline operations - [getOfflineQueueStatus](https://docs.connvo.app/api-reference/notes/getofflinequeuestatus.md): Calls a mutation at the path notes/index.js:getOfflineQueueStatus - [getOfflineQueueStatus](https://docs.connvo.app/api-reference/notes/getofflinequeuestatus-1.md): Gets offline operation queue status for a client - [queueOfflineOperations](https://docs.connvo.app/api-reference/notes/queueofflineoperations.md): Calls a mutation at the path notes/index.js:queueOfflineOperations - [queueOfflineOperations](https://docs.connvo.app/api-reference/notes/queueofflineoperations-1.md): Queues operations for offline sync - [restoreFromCheckpoint](https://docs.connvo.app/api-reference/notes/restorefromcheckpoint.md): Calls a mutation at the path notes/index.js:restoreFromCheckpoint - [restoreFromCheckpoint](https://docs.connvo.app/api-reference/notes/restorefromcheckpoint-1.md): Restores from an offline checkpoint - [retryFailedOperations](https://docs.connvo.app/api-reference/notes/retryfailedoperations.md): Calls a mutation at the path notes/index.js:retryFailedOperations - [retryFailedOperations](https://docs.connvo.app/api-reference/notes/retryfailedoperations-1.md): Retries failed offline operations - [rollbackToSequence](https://docs.connvo.app/api-reference/notes/rollbacktosequence.md): Calls a mutation at the path notes/index.js:rollbackToSequence - [rollbackToSequence](https://docs.connvo.app/api-reference/notes/rollbacktosequence-1.md): the notes document from the remaining operations. This is used for administrative recovery from errors or malicious edits. Requires host permissions. The rollback is logged in the audit trail with the reason provided. After removing operations, the document is rebased from scratch to ensure consiste… - [syncOfflineOperations](https://docs.connvo.app/api-reference/notes/syncofflineoperations.md): Calls a mutation at the path notes/index.js:syncOfflineOperations - [syncOfflineOperations](https://docs.connvo.app/api-reference/notes/syncofflineoperations-1.md): Syncs queued offline operations with conflict resolution - [generatePreCallIdeas](https://docs.connvo.app/api-reference/prompts/generateprecallideas.md): Calls a action at the path prompts/actions.js:generatePreCallIdeas - [generatePreCallIdeas](https://docs.connvo.app/api-reference/prompts/generateprecallideas-1.md): Calls a action at the path prompts/index.js:generatePreCallIdeas - [getInCallPrompts](https://docs.connvo.app/api-reference/prompts/getincallprompts.md): Calls a query at the path prompts/index.js:getInCallPrompts - [getInCallPrompts](https://docs.connvo.app/api-reference/prompts/getincallprompts-1.md): Calls a query at the path prompts/queries.js:getInCallPrompts - [getPreCallPrompts](https://docs.connvo.app/api-reference/prompts/getprecallprompts.md): Calls a query at the path prompts/index.js:getPreCallPrompts - [getPreCallPrompts](https://docs.connvo.app/api-reference/prompts/getprecallprompts-1.md): Calls a query at the path prompts/queries.js:getPreCallPrompts - [subscribeToInCallPrompts](https://docs.connvo.app/api-reference/prompts/subscribetoincallprompts.md): Calls a query at the path prompts/index.js:subscribeToInCallPrompts - [subscribeToInCallPrompts](https://docs.connvo.app/api-reference/prompts/subscribetoincallprompts-1.md): Calls a query at the path prompts/queries.js:subscribeToInCallPrompts - [updatePromptFeedback](https://docs.connvo.app/api-reference/prompts/updatepromptfeedback.md): Calls a mutation at the path prompts/index.js:updatePromptFeedback - [updatePromptFeedback](https://docs.connvo.app/api-reference/prompts/updatepromptfeedback-1.md): Calls a mutation at the path prompts/mutations.js:updatePromptFeedback - [batchUpdatePresence](https://docs.connvo.app/api-reference/system/batchupdatepresence.md): Batched presence updates with latest-state-wins coalescing - [calculateCompatibilityScore](https://docs.connvo.app/api-reference/system/calculatecompatibilityscore.md): Calls a action at the path matching/index.js:calculateCompatibilityScore - [calculateCompatibilityScore](https://docs.connvo.app/api-reference/system/calculatecompatibilityscore-1.md): Calculate compatibility score between two users (public API) - [cancelQueueEntry](https://docs.connvo.app/api-reference/system/cancelqueueentry.md): Calls a mutation at the path matching/index.js:cancelQueueEntry - [cancelQueueEntry](https://docs.connvo.app/api-reference/system/cancelqueueentry-1.md): Cancel user's queue entry - [checkBandwidthLimit](https://docs.connvo.app/api-reference/system/checkbandwidthlimit.md): Check bandwidth limits for a user request - [enterMatchingQueue](https://docs.connvo.app/api-reference/system/entermatchingqueue.md): Calls a mutation at the path matching/index.js:enterMatchingQueue - [enterMatchingQueue](https://docs.connvo.app/api-reference/system/entermatchingqueue-1.md): Enter the matching queue with availability window and constraints - [establishSubscription](https://docs.connvo.app/api-reference/system/establishsubscription.md): Establishes a new subscription with comprehensive validation - [executeWithCircuitBreaker](https://docs.connvo.app/api-reference/system/executewithcircuitbreaker.md): Execute operation with circuit breaker protection - [flushAllBatches](https://docs.connvo.app/api-reference/system/flushallbatches.md): Flush all pending batches (for testing or shutdown) - [generateEmbedding](https://docs.connvo.app/api-reference/system/generateembedding.md): Generate embedding for content (public) - [generateEmbedding](https://docs.connvo.app/api-reference/system/generateembedding-1.md): Calls a action at the path embeddings/index.js:generateEmbedding - [getActiveQueueEntries](https://docs.connvo.app/api-reference/system/getactivequeueentries.md): Get active queue entries for matching processing (internal use) - [getAuditLogs](https://docs.connvo.app/api-reference/system/getauditlogs.md): Public query to list audit logs by resource - [getBandwidthStats](https://docs.connvo.app/api-reference/system/getbandwidthstats.md): Get bandwidth usage statistics - [getBatchStats](https://docs.connvo.app/api-reference/system/getbatchstats.md): Get batch processing statistics - [getCircuitBreakerStatus](https://docs.connvo.app/api-reference/system/getcircuitbreakerstatus.md): Get circuit breaker status for all services - [getEmbedding](https://docs.connvo.app/api-reference/system/getembedding.md): Calls a query at the path embeddings/index.js:getEmbedding - [getEmbedding](https://docs.connvo.app/api-reference/system/getembedding-1.md): Get embedding by ID (public) - [getEmbeddingsByModel](https://docs.connvo.app/api-reference/system/getembeddingsbymodel.md): Calls a query at the path embeddings/index.js:getEmbeddingsByModel - [getEmbeddingsByModel](https://docs.connvo.app/api-reference/system/getembeddingsbymodel-1.md): Get embeddings by model (public) - [getEmbeddingsBySource](https://docs.connvo.app/api-reference/system/getembeddingsbysource.md): Calls a query at the path embeddings/index.js:getEmbeddingsBySource - [getEmbeddingsBySource](https://docs.connvo.app/api-reference/system/getembeddingsbysource-1.md): Get embeddings by source (public) - [getFunctionPerformanceBreakdown](https://docs.connvo.app/api-reference/system/getfunctionperformancebreakdown.md): Function-level performance breakdown - [getMatchHistory](https://docs.connvo.app/api-reference/system/getmatchhistory.md): Calls a query at the path matching/index.js:getMatchHistory - [getMatchingStats](https://docs.connvo.app/api-reference/system/getmatchingstats.md): Calls a query at the path matching/index.js:getMatchingStats - [getPerformanceMetrics](https://docs.connvo.app/api-reference/system/getperformancemetrics.md): Real-time performance metrics query - [getPerformanceTrends](https://docs.connvo.app/api-reference/system/getperformancetrends.md): Performance trend analysis - [getQueueStatus](https://docs.connvo.app/api-reference/system/getqueuestatus.md): Calls a query at the path matching/index.js:getQueueStatus - [getQueueStatus](https://docs.connvo.app/api-reference/system/getqueuestatus-1.md): Get current queue status for a user - [getSLOStatus](https://docs.connvo.app/api-reference/system/getslostatus.md): Real-time SLO monitoring with alerting - [getSubscriptionMetrics](https://docs.connvo.app/api-reference/system/getsubscriptionmetrics.md): WebSocket subscription performance metrics - [getSubscriptionStats](https://docs.connvo.app/api-reference/system/getsubscriptionstats.md): Get subscription statistics for monitoring - [getVectorIndexMeta](https://docs.connvo.app/api-reference/system/getvectorindexmeta.md): Calls a query at the path embeddings/index.js:getVectorIndexMeta - [getVectorIndexMeta](https://docs.connvo.app/api-reference/system/getvectorindexmeta-1.md): Get vector index metadata (public) - [listCatalog](https://docs.connvo.app/api-reference/system/listcatalog.md): Calls a query at the path interests/queries.js:listCatalog - [optimizeMatchingWeights](https://docs.connvo.app/api-reference/system/optimizematchingweights.md): Calls a action at the path matching/index.js:optimizeMatchingWeights - [recordCustomMetric](https://docs.connvo.app/api-reference/system/recordcustommetric.md): Record custom performance metric - [refreshSubscriptionPermissions](https://docs.connvo.app/api-reference/system/refreshsubscriptionpermissions.md): Calls a query at the path auth/permissions.js:refreshSubscriptionPermissions - [resetCircuitBreaker](https://docs.connvo.app/api-reference/system/resetcircuitbreaker.md): Reset circuit breaker for a service - [runMatchingCycle](https://docs.connvo.app/api-reference/system/runmatchingcycle.md): Run matching cycle with shard-based processing for scalability - [runMatchingCycle](https://docs.connvo.app/api-reference/system/runmatchingcycle-1.md): Calls a action at the path matching/index.js:runMatchingCycle - [shouldShedLoad](https://docs.connvo.app/api-reference/system/shouldshedload.md): Load shedding based on system load - [submitMatchFeedback](https://docs.connvo.app/api-reference/system/submitmatchfeedback.md): Calls a mutation at the path matching/index.js:submitMatchFeedback - [terminateSubscription](https://docs.connvo.app/api-reference/system/terminatesubscription.md): Terminates subscription and cleans up resources - [updateQueueStatus](https://docs.connvo.app/api-reference/system/updatequeuestatus.md): Update queue entry status (internal use for matching engine) - [validateAndLogSubscription](https://docs.connvo.app/api-reference/system/validateandlogsubscription.md): Calls a action at the path realtime/subscriptionActions.js:validateAndLogSubscription - [validateAndUpdateSubscription](https://docs.connvo.app/api-reference/system/validateandupdatesubscription.md): Validates and updates subscription permissions in real-time - [validateSubscription](https://docs.connvo.app/api-reference/system/validatesubscription.md): Called periodically by clients to ensure continued access - [validateSubscriptionPermissions](https://docs.connvo.app/api-reference/system/validatesubscriptionpermissions.md): Calls a query at the path auth/permissions.js:validateSubscriptionPermissions - [vectorSimilaritySearch](https://docs.connvo.app/api-reference/system/vectorsimilaritysearch.md): Calls a query at the path embeddings/index.js:vectorSimilaritySearch - [vectorSimilaritySearch](https://docs.connvo.app/api-reference/system/vectorsimilaritysearch-1.md): Perform vector similarity search (public) - [batchIngestTranscriptChunk](https://docs.connvo.app/api-reference/transcripts/batchingesttranscriptchunk.md): Batched transcript ingestion with coalescing - [getTranscriptChunks](https://docs.connvo.app/api-reference/transcripts/gettranscriptchunks.md): sequence number and time bucket. Supports pagination with configurable limits (max 200 per request). Uses query optimizer for efficient index-backed retrieval. Requires meeting participant access. Returns chunks in ascending sequence order. - [getTranscriptStats](https://docs.connvo.app/api-reference/transcripts/gettranscriptstats.md): including total chunks, word count, average confidence, duration, unique speakers, languages detected, and bucket count for sharding metrics. Requires meeting participant access. Returns zero values for meetings with no transcripts. - [ingestTranscriptChunk](https://docs.connvo.app/api-reference/transcripts/ingesttranscriptchunk.md): validates input parameters, enforces rate limits per user, and stores chunks in time-bucketed shards (5-minute windows) to prevent hot partitions. Allocates globally unique sequence numbers for ordering. Returns rate limit status for client-side throttling. - [subscribeTranscriptStream](https://docs.connvo.app/api-reference/transcripts/subscribetranscriptstream.md): Real-time transcript stream subscription with time-bounded access - [deactivateUser](https://docs.connvo.app/api-reference/users/deactivateuser.md): Marks a user account as inactive, preventing them from accessing the platform. Validates that the user exists and is not already deactivated. In a complete implementation, this would also cancel active meetings, remove from matching queues, and clean up active sessions. Requires the authenticated us… - [getCurrentUser](https://docs.connvo.app/api-reference/users/getcurrentuser.md): Returns the full user document for the currently authenticated user based on their WorkOS identity. Returns null if the user is not authenticated, allowing clients to safely subscribe without triggering errors during logged-out states. This is the primary method for retrieving the current user's dat… - [getCurrentUserProfile](https://docs.connvo.app/api-reference/users/getcurrentuserprofile.md): Gets current user's profile - [getOnboardingState](https://docs.connvo.app/api-reference/users/getonboardingstate.md): Returns the onboarding completion status for the currently authenticated user, including whether they have completed onboarding, whether a profile exists, and the completion timestamp. Used by the frontend to determine which onboarding steps to display. Requires authentication. - [getProfileByUserIdPublic](https://docs.connvo.app/api-reference/users/getprofilebyuseridpublic.md): Gets profile by user ID with authorization - [getUserById](https://docs.connvo.app/api-reference/users/getuserbyid.md): Returns the full user document for the supplied `userId`. This wrapper exists for non-sensitive tooling and tests; clients should prefer `getCurrentUser` or scoped profile queries when they need authorization filtering. - [getUserInsights](https://docs.connvo.app/api-reference/users/getuserinsights.md): Calls a query at the path insights/index.js:getUserInsights - [getUserInsights](https://docs.connvo.app/api-reference/users/getuserinsights-1.md): Calls a query at the path insights/queries.js:getUserInsights - [getUserProfile](https://docs.connvo.app/api-reference/users/getuserprofile.md): Returns a user profile with privacy-controlled access to organization information. Organization details (orgId, orgRole) are only included if the requesting user is in the same organization or has admin privileges. Returns null if the user does not exist. Requires authentication. - [listActiveUsersInOrg](https://docs.connvo.app/api-reference/users/listactiveusersinorg.md): Returns a paginated list of active users within the authenticated user's organization. Only returns public-safe user data (ID, display name, avatar, active status). Uses index-first query pattern for optimal performance. Returns an empty list if the user is not part of an organization. Requires auth… - [listUserMeetings](https://docs.connvo.app/api-reference/users/listusermeetings.md): with optional filtering by meeting state (scheduled, active, concluded, cancelled). Results are sorted by creation time (newest first) and limited to prevent excessive data transfer. Includes the user's role and presence status for each meeting. - [saveOnboarding](https://docs.connvo.app/api-reference/users/saveonboarding.md): Atomically persists a member's onboarding payload – profile metadata, interest selections, and completion flags – while enforcing validation rules and idempotency. The mutation uses a scoped idempotency key so the same payload can be retried without duplicating interests or profiles. - [updateLastSeen](https://docs.connvo.app/api-reference/users/updatelastseen.md): Updates the lastSeenAt timestamp for the currently authenticated user to the current time. Used for presence tracking and activity monitoring. This is typically called periodically by the client to indicate the user is still active. Requires authentication. - [updateUserInterests](https://docs.connvo.app/api-reference/users/updateuserinterests.md): Replaces all existing user interests with the provided list. Validates that all interest keys exist in the interests catalog before applying changes. Removes all existing interests and creates new associations atomically. Requires the authenticated user to own the profile or have admin privileges. - [updateUserProfile](https://docs.connvo.app/api-reference/users/updateuserprofile.md): Updates or creates a user profile with the provided information. If a profile already exists for the user, updates the specified fields; otherwise creates a new profile. Validates input constraints (display name not empty, bio max 1000 characters). Requires the authenticated user to own the profile… - [upsertUser](https://docs.connvo.app/api-reference/users/upsertuser.md): Upserts a user record based on WorkOS authentication data. If a user with the given WorkOS ID already exists, updates their information; otherwise creates a new user. This is typically called after successful WorkOS authentication to ensure the user exists in the database. Requires authentication to… - [Authentication](https://docs.connvo.app/authentication.md): Authenticate with Connvo using WorkOS-issued bearer tokens and deploy keys. - [Connvo API Overview](https://docs.connvo.app/introduction.md): Understand the scope of the Connvo Convex API and where to find reference material. ## OpenAPI Specs - [convex-openapi](https://docs.connvo.app/api-reference/convex-openapi.yaml) - [openapi](https://docs.connvo.app/openapi.yaml)