Summary (AI)

If transcription was enabled in the session, you can request a summary through the sessions/:id/summary endpoint. The transcripts will be passed through an AI (Artificial Intelligence) and a few sentences summary describing what happened in the session will be generated.

We self-host our AI models, and your sensitive transcript data is NOT being transmitted to any third party AI services.

Generation of summary is not an immediate operation, that's why the first response you receive will be with an "in progress" status.

{"id":"c9ea5206-a44a-4d36-b685-5bbed86e9c8e","status":"IN_PROGRESS","summary":""}

You can keep polling the same endpoint every minute or so until you receive the summary: {"id":"c9ea5206-a44a-4d36-b685-5bbed86e9c8e","status":"READY","summary":"Starship is a two-stage super heavy lift launch vehicle developed by SpaceX to significantly lower launch costs through economies of scale. It has a primary objective of reusing both rocket stages, increasing payload mass to orbit, and adapting to various space missions. The rocket will perform a wide range of missions, including those to geosynchronous orbit, the Moon, and Mars. Starship relies on orbital refueling from its tanker variant and is designed to be fully reusable. It has two stages: the Super Heavy Booster and the Starship spacecraft, both equipped with Raptor engines that burn liquid methane and oxygen. The rocket's structure is made of stainless steel, and it will use mechanical arms attached to the launch tower for landing."}

Request

cURL

curl --request GET \
  --url https://api.digitalsamba.com/api/v1/sessions/edb7a1cb-0627-44ed-9ae4-62a344d6e8a9/summary \
  --user YOUR_TEAM_ID:YOUR_DEVELOPER_KEY

Java

import com.fasterxml.jackson.databind.ObjectMapper;

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
import java.util.Base64;
import java.util.Map;

String TEAM_ID = "YOUR_TEAM_ID";
String DEVELOPER_KEY = "YOUR_DEVELOPER_KEY";
String authorizationHeader = "Bearer " + Base64.getEncoder().encodeToString((TEAM_ID + ":" + DEVELOPER_KEY).getBytes());

String sessionId = "edb7a1cb-0627-44ed-9ae4-62a344d6e8a9";

HttpRequest request = HttpRequest.newBuilder()
  .GET()
  .uri(new URI("https://api.digitalsamba.com/api/v1/sessions/" + sessionId + "/summary"))
  .header("Authorization", authorizationHeader)
  .build();

HttpClient client = HttpClient.newHttpClient();
HttpResponse<String> response = client.send(request, BodyHandlers.ofString());

System.out.println("Status code: " + response.statusCode());
System.out.println("Body: " + response.body());

Response (200 OK). Initial response tells you the summary generation is in progress. Keep calling the same endpoint every minute or so until the summary is generated.

{
  "id":"c9ea5206-a44a-4d36-b685-5bbed86e9c8e",
  "status":"IN_PROGRESS",
  "summary":""
}

After some time when summary is generated you will receive this:

{
  "id":"c9ea5206-a44a-4d36-b685-5bbed86e9c8e",
  "summary": "Starship is a two-stage super heavy lift launch vehicle developed by SpaceX to significantly lower launch costs through economies of scale. It has a primary objective of reusing both rocket stages, increasing payload mass to orbit, and adapting to various space missions. The rocket will perform a wide range of missions, including those to geosynchronous orbit, the Moon, and Mars. Starship relies on orbital refueling from its tanker variant and is designed to be fully reusable. It has two stages: the Super Heavy Booster and the Starship spacecraft, both equipped with Raptor engines that burn liquid methane and oxygen. The rocket's structure is made of stainless steel, and it will use mechanical arms attached to the launch tower for landing."
}