---
title: "Generate Call Summary"
method: POST
path: "/summary/{session_id}"
tags: ["summary"]
---

# Generate Call Summary

`POST /summary/{session_id}`

## Request

- Base URL: `https://dev.whispa.net` (the document declares no server; this is the origin it was published from)
- URL: `https://dev.whispa.net/summary/{session_id}`
- Auth: one of:
  - OAuth 2
    - Password
    - Token URL: `auth/bearer/login`
  - API key in cookie `access_token`

Generate a call summary for a completed call session and store it.

## Path parameters

- `session_id` string, uuid, required

## Request body

- SummaryRequest: Request to generate call summary.
  - `transcript` TranscriptEntry[], required: Conversation transcript
    - `speaker` string, required: Speaker identifier (e.g., 'agent', 'customer')
    - `text` string, required: The spoken text
    - `start_time` number, nullable: Seconds from call start (positions timeline markers)
  - `scenario` string, nullable: Optional fallback when the call has no persisted scenario

## Response `200`

Successful Response

- SummaryResponse: Response containing call summary.
  - `success` boolean, required: Whether summary generation succeeded
  - `session_id` string, required: Session ID
  - `summary_markdown` string, nullable: Free-form markdown summary of the call
  - `talk_time_stats` TalkTimeStats: Talk time statistics for a call.
    - `agent_percentage` integer, required: Percentage of talk time by the agent
    - `customer_percentage` integer, required: Percentage of talk time by the customer
    - `agent_utterances` integer, required: Number of utterances by the agent
    - `customer_utterances` integer, required: Number of utterances by the customer

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/whispa/apis/whispa-api.md) - [All operations](https://skmtc.dev/whispa/apis/whispa-api/llms.txt) - [OpenAPI document](https://skmtc.dev/whispa/apis/whispa-api/revisions/12c2e4aca43c?raw)