Poll Session Status Before Fetching Content

Problem: Content or note APIs return empty or incomplete results right after end session. Solution: Poll Get ambient session status until completed, then retrieve. Treat skipped, failed, and aborted as terminal.

This cookbook assumes you already have your Partner ID, authentication tokens, and the other prerequisites for Ambient APIs.

TypeScript
Python

async function waitUntilCompleted(ambientSessionId: string) {
  for (let i = 0; i < 60; i++) {
    const res = await fetch(
      `https://sdp.suki.ai/api/v1/ambient/session/${ambientSessionId}/status`,
      {
        headers: {
          sdp_suki_token: sdpSukiToken,
          sdp_provider_id: sdpProviderId,
        },
      }
    );

    if (!res.ok) {
      throw new Error(`Get ambient session status failed: ${res.status}`);
    }

    const { status } = await res.json();
    if (status === "completed") return "completed";
    if (status === "skipped" || status === "failed" || status === "aborted") {
      return status;
    }

    await new Promise((r) => setTimeout(r, 2000));
  }

  throw new Error("Timed out waiting for session status");
}

const outcome = await waitUntilCompleted(ambientSessionId);
if (outcome === "completed") {
  // Call session content or note content APIs
}

import time
import requests

def wait_until_completed(ambient_session_id: str) -> str:
    for _ in range(60):
        res = requests.get(
            f"https://sdp.suki.ai/api/v1/ambient/session/{ambient_session_id}/status",
            headers={
                "sdp_suki_token": sdp_suki_token,
                "sdp_provider_id": sdp_provider_id,
            },
        )
        res.raise_for_status()
        status = res.json().get("status")
        if status == "completed":
            return "completed"
        if status in ("skipped", "failed", "aborted"):
            return status
        time.sleep(2)
    raise TimeoutError("Timed out waiting for session status")

outcome = wait_until_completed(ambient_session_id)
if outcome == "completed":
    # Call session content or note content APIs
    pass

Common mistakes

Sessions under ~1 minute often return skipped.
WebSocket close alone does not mean the note is ready.

Other cookbooks

AmbientAPI

Fetch Note Content with composition_id

Retrieve the note with composition_id.

5 min

AmbientAPI

Clear a Remote Session Conflict

End remote session, then retry.

5 min

​Common mistakes

​Other cookbooks

​Fetch Note Content with composition_id

​Clear a Remote Session Conflict

Common mistakes

Other cookbooks

Fetch Note Content with composition_id

Clear a Remote Session Conflict