Transcripts API

Fetch transcripts, create shareable links, and export transcript data.

GET/transcripts/{platform}/{native_meeting_id}

Get Transcripts

Get all transcript segments for a meeting. Returns both the transcript data and meeting metadata.

Dashboard Proxy: The dashboard calls /api/vexa/transcripts/{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

Code Examples

curl -X GET "https://api.cloud.vexa.ai/transcripts/{platform}/{native_meeting_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": "completed",
  "start_time": "2024-01-01T12:00:00Z",
  "end_time": "2024-01-01T13:00:00Z",
  "segments": [
    {
      "start": 0,
      "end": 5.2,
      "text": "Hello everyone, welcome to today's meeting.",
      "speaker": "Alice",
      "language": "en",
      "absolute_start_time": "2024-01-01T12:00:00Z",
      "absolute_end_time": "2024-01-01T12:00:05Z",
      "created_at": "2024-01-01T12:00:05Z"
    }
  ]
}

Error Responses

404The specified meeting does not exist

{
  "error": "Meeting not found"
}

Notes

Segments are returned in chronological order
Each segment includes speaker identification, timestamps, and text
For active meetings, segments may be incomplete (mutable)

POST/transcripts/{platform}/{native_meeting_id}/share

Create Transcript Share Link

Create a short-lived public URL for sharing transcripts with external tools like ChatGPT or Perplexity.

Dashboard Proxy: The dashboard calls /api/vexa/transcripts/{platform}/{native_meeting_id}/share 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

Query Parameters

meeting_id

meeting_idinteger

Optional meeting ID for reference

ttl_seconds

ttl_secondsinteger

Time-to-live in seconds (default: 3600)

Code Examples

curl -X POST "https://api.cloud.vexa.ai/transcripts/{platform}/{native_meeting_id}/share?meeting_id=your_meeting_id&ttl_seconds=your_ttl_seconds" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "share_id": "abc123def456",
  "url": "https://api.vexa.ai/public/transcripts/abc123def456.txt",
  "expires_at": "2024-01-01T13:00:00Z",
  "expires_in_seconds": 3600
}

Notes

Share links are public and do not require authentication
Links expire after the specified TTL (default: 1 hour)
Useful for sharing transcripts with AI tools that can read from URLs