Skip to main content
For step-by-step integration flows, start with the Media & Transcriptions guide.

​
Four integration paths

PathBest forSidebar group
TranscriptionsText you already have — fragments, summaries, insights, translationsEvent — Media → Transcriptions
Session recordingsAudio for a session’s recording archiveEvent — Media → Session recordings
Media uploadVideo or audio files that should be transcribed automaticallyEvent — Media → Media upload
Session filesPDFs, PowerPoint, Word docs, and similar attachmentsEvent — Media → Session files
Session files (slides, handouts, PDFs) support a one-call multipart upload (POST .../files/upload, max 50 MB) or direct-to-storage for larger files (up to 500 MB). Scopes: read:sessions / write:sessions. See Uploading session files and the Session Files API overview.

​
Resource model

Transcription data uses four types, all tied to a session:
TypeDescription
fragmentTranscript text (synced by you or created when media transcription completes)
summaryStructured summary content
insightTopics, entities, or key phrases
translationTranslated text linked to a source artifact
Responses use the standard envelope: 
{
  "data": {
    "id": "uuid",
    "type": "fragment",
    "session_id": "uuid",
    "transcription": "...",
    "created_at": "...",
    "updated_at": "..."
  }
}
List endpoints include pagination with current_page, page_size, total_pages, and total_results.

​
Transcriptions

List event transcriptions

GET /v1/event//transcriptions

List session transcriptions

GET /v1/event//sessions//transcriptions

Get session transcription

GET /v1/event//sessions//transcriptions/

Create transcription

POST /v1/event//sessions//transcriptions

​
Session recordings

List session recordings

GET /v1/event//sessions//recordings

Start recording upload

POST /v1/event//sessions//recordings

Get session recording

GET /v1/event//sessions//recordings/

Complete recording upload

POST …/recordings//complete

​
Session files

Document attachments (PDF, PowerPoint, Word, images). Full playbook: Uploading session files. API overview: Session Files.

List session files

GET /v1/event//sessions//files

Simple file upload

POST /v1/event//sessions//files/upload

Direct-to-storage create

POST /v1/event//sessions//files

Complete file upload

POST …/files//complete

Session files guide

Replace, update metadata, delete

​
Media upload

Start media upload

POST …/media/upload/initiate

Get media item status

GET /v1/event//sessions//media/