Meetings API

Manage meetings, update metadata, and track meeting status.

GET/meetings

List Meetings

Get a list of all meetings for the authenticated user.

Dashboard Proxy: The dashboard calls /api/vexa/meetings which forwards to this endpoint.

Authentication

Requires User API Key in X-API-Key header.

Code Examples

curl -X GET "https://api.cloud.vexa.ai/meetings" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "meetings": [
    {
      "id": 123,
      "platform": "google_meet",
      "native_meeting_id": "abc-defg-hij",
      "status": "completed",
      "start_time": "2024-01-01T12:00:00Z",
      "end_time": "2024-01-01T13:00:00Z",
      "bot_container_id": null,
      "data": {
        "name": "Team Standup",
        "participants": [
          "Alice",
          "Bob"
        ]
      },
      "created_at": "2024-01-01T12:00:00Z"
    }
  ]
}

Notes

Returns meetings sorted by creation date (newest first)
Includes meetings in all statuses: requested, joining, active, completed, failed

GET/meetings/{id}

Get Meeting

Get detailed information about a specific meeting.

Dashboard Proxy: The dashboard calls /api/vexa/meetings/{id} which forwards to this endpoint.

Authentication

Requires User API Key in X-API-Key header.

Path Parameters

id

idintegerRequired

The meeting ID

Code Examples

curl -X GET "https://api.cloud.vexa.ai/meetings/{id}" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "id": 123,
  "platform": "google_meet",
  "native_meeting_id": "abc-defg-hij",
  "status": "active",
  "start_time": "2024-01-01T12:00:00Z",
  "end_time": null,
  "bot_container_id": "container-123",
  "data": {
    "name": "Team Standup",
    "participants": [
      "Alice",
      "Bob"
    ],
    "languages": [
      "en"
    ]
  },
  "created_at": "2024-01-01T12:00:00Z"
}

Error Responses

404The specified meeting does not exist

{
  "error": "Meeting not found"
}

PATCH/meetings/{platform}/{native_meeting_id}

Update Meeting Data

Update meeting metadata such as name, notes, participants, and languages.

Dashboard Proxy: The dashboard calls /api/vexa/meetings/{platform}/{native_meeting_id} which forwards to this endpoint.

Authentication

Requires User API Key in X-API-Key header.

Path Parameters

platform

platformstringRequired

Meeting platform: google_meet or teams

native_meeting_id

native_meeting_idstringRequired

The platform-specific meeting ID

Request Body

Meeting data updates

{
  "data": {
    "name": "Updated Meeting Name",
    "notes": "Meeting notes here",
    "participants": [
      "Alice",
      "Bob",
      "Charlie"
    ],
    "languages": [
      "en",
      "es"
    ]
  }
}

Code Examples

curl -X PATCH "https://api.cloud.vexa.ai/meetings/{platform}/{native_meeting_id}" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "data": {
    "name": "Updated Meeting Name",
    "notes": "Meeting notes here",
    "participants": [
      "Alice",
      "Bob",
      "Charlie"
    ],
    "languages": [
      "en",
      "es"
    ]
  }
}'

Response

{
  "id": 123,
  "platform": "google_meet",
  "native_meeting_id": "abc-defg-hij",
  "status": "active",
  "data": {
    "name": "Updated Meeting Name",
    "notes": "Meeting notes here",
    "participants": [
      "Alice",
      "Bob",
      "Charlie"
    ],
    "languages": [
      "en",
      "es"
    ]
  }
}

Notes

All fields in the data object are optional
Only provided fields will be updated
Useful for adding context and metadata to meetings