Meeting Audio API

Manage audio recordings and transcriptions from meetings.

Download Audio

Download the audio recording for a specific meeting.

GET/v1/audio/{meeting_id}/download

Query Parameters

format

stringDefault: webm

Audio format to download

start_time

string

Start timestamp for partial download (ISO 8601 format)

end_time

string

End timestamp for partial download (ISO 8601 format)

curl -X GET "https://api.vexa.ai/v1/audio/{meeting_id}/download" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

Binary audio file content

Delete Audio

Delete an audio recording.

DELETE/v1/audio/{meeting_id}

curl -X DELETE "https://api.vexa.ai/v1/audio/{meeting_id}" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "status": "deleted",
  "meeting_id": "meeting_12345"
}

List Recordings

List all available recordings.

GET/v1/audio/recordings

Query Parameters

page

integerDefault: 1

Page number for pagination

limit

integerDefault: 20

Number of recordings per page

start_date

string

Filter by start date (ISO 8601 format)

end_date

string

Filter by end date (ISO 8601 format)

curl -X GET "https://api.vexa.ai/v1/audio/recordings" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "recordings": [
    {
      "meeting_id": "meeting_12345",
      "duration_seconds": 3600,
      "start_time": "2024-03-27T18:30:00Z",
      "end_time": "2024-03-27T19:30:00Z",
      "size_bytes": 15000000,
      "format": "webm"
    }
  ],
  "total": 50,
  "page": 1,
  "pages": 3
}

Get Transcription

Get the transcription for a specific recording.

GET/v1/audio/{meeting_id}/transcription

Query Parameters

format

stringDefault: json

Response format

include_speaker_labels

booleanDefault: true

Include speaker identification

include_timestamps

booleanDefault: false

Include word-level timestamps

curl -X GET "https://api.vexa.ai/v1/audio/{meeting_id}/transcription" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "meeting_id": "meeting_12345",
  "duration_seconds": 3600,
  "segments": [
    {
      "start_time": "00:00:00",
      "end_time": "00:00:05",
      "speaker": "Speaker 1",
      "text": "Hello everyone, welcome to the meeting.",
      "words": [
        {
          "word": "Hello",
          "start": 0.0,
          "end": 0.5,
          "confidence": 0.98
        }
      ]
    }
  ]
}