Start a meeting in workspace

Developing

Develop Env

http://localhost:3000/api

POST

/workspaces/{workspace_id}/meetings

Maintainer:Suhaib Ghattass

Purpose
Schedule or immediately start a new meeting within a workspace. Supports lecture mode (education), agile standups (business), and custom retention policies. Used by users to initiate collaboration sessions.

Auth / Scope
User must be a member of the workspace with meeting:create permission (typically member+).
If org.settings.complianceMode = "ferpa" or "hipaa", recording/transcription requires explicit consent flow.

Headers
Content-Type: application/json
Authorization: Bearer <USER_JWT>
Idempotency-Key: (recommended)
X-Request-ID:
Idempotency & retries
Same Idempotency-Key → returns existing meeting (201) or 409 if payload differs.

Rate limits
30 requests/hour per user (to prevent spam)
Returns 429 with Retry-After if exceeded

Request

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://localhost:3000/api/workspaces//meetings' \
--header 'Content-Type: application/json' \
--data-raw '{
    "title": "CS101 Lecture: Neural Networks",
    "start_time": "2025-10-25T14:00:00Z",
    "end_time": "2025-10-25T15:30:00Z",
    "mode": "lecture",
    "retention_policy": {
        "transcripts": "730d",
        "recordings": "365d",
        "examData": "3650d"
    },
    "settings": {
        "educationMode": true,
        "beginnerModeDefault": true,
        "recordingConsent": "required",
        "realTimeSummaries": true,
        "breakoutRooms": false
    },
    "supportedLanguages": [
        "en-US",
        "es-ES"
    ],
    "featureFlags": {
        "examGeneration": true,
        "roleAwareSummaries": true
    }
}'

Response Example

{
    "message": "Meeting created successfully",
    "data": {
        "meetingId": "m-abc123def456",
        "workspaceId": "w-xyz789",
        "orgId": "o-123",
        "title": "CS101 Lecture: Neural Networks",
        "room_id": "livekit_room_abc123",
        "state": "scheduled",
        "start_time": "2025-10-25T14:00:00Z",
        "end_time": "2025-10-25T15:30:00Z",
        "created_by": "u-9f8e7d6c-...",
        "retention_policy": { ...
        },
        "settings": { ...
        },
        "join_url": "https://app.cognita.ai/meet/m-abc123def456",
        "created_at": "2025-10-22T18:00:00Z"
    }
}

Modified at 2025-10-22 21:44:10

Delete Member from Workspace

OrganizationSettings