Sessions

Bulk export sessions

Fetch multiple sessions by ID in a single request. Max 50 session IDs per request. Set include_transcript: true to include full transcripts in the response (requires the transcripts:read scope). Ideal for backfilling a knowledge base from history.

post/v1/sessions/bulk

Request

  • Base URL: https://api.wave.co
  • URL: https://api.wave.co/v1/sessions/bulk
  • Auth: HTTP bearer

Request body

session_idsstring[] required
include_transcriptboolean
include_summaryboolean

Example request

{
  "session_ids": [
    "sess_01HX4R7MT8PQZ6VCN9ABYF2KJM",
    "sess_01HX3P8YVJ9WX1MKBQ2NTD5VGH"
  ],
  "include_transcript": true,
  "include_summary": true
}

Response

Bulk export results

Example response

{
  "sessions": [
    {
      "id": "sess_01HX4R7MT8PQZ6VCN9ABYF2KJM",
      "title": "Weekly product sync",
      "timestamp": "2025-04-18T16:00:00.000Z",
      "duration_seconds": 1812,
      "type": "meeting",
      "platform": "zoom",
      "language": "en",
      "summary": "## Overview\nQuarterly roadmap review…",
      "transcript": "Josh: Alright, let’s kick off the roadmap review.…"
    }
  ],
  "errors": [
    {
      "id": "sess_does_not_exist",
      "error": "not_found"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.