Sessions

Search sessions

Semantic search across all sessions using vector similarity. Each result includes a snippet — useful for triage without pulling the full session. Pass tags + tag_mode to restrict the vector search to sessions carrying specific tags (exact, case-sensitive).

post/v1/sessions/search

Request

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

Request body

querystring required
limitinteger
tagsstring[]
tag_mode'any' | 'all'

Example request

{
  "query": "retail media strategy",
  "limit": 10,
  "tags": [
    "work"
  ],
  "tag_mode": "any"
}

Response

Search results

querystring required
totalnumber required

Example response

{
  "query": "retail media strategy",
  "results": [
    {
      "id": "sess_01HX4R7MT8PQZ6VCN9ABYF2KJM",
      "title": "Weekly product sync",
      "timestamp": "2025-04-18T16:00:00.000Z",
      "type": "meeting",
      "similarity": 0.87,
      "snippet": "…we want to lead with retail media strategy in Q3, starting with the Instacart rollout…"
    }
  ],
  "total": 1
}

Changes

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