---
title: "Generate Conversation Summary Endpoint"
method: POST
path: "/v1/conversation/{lead_id}/summary"
tags: ["conversation"]
---

# Generate Conversation Summary Endpoint

`POST /v1/conversation/{lead_id}/summary`

## Request

- Base URL: `https://client.api.prod.orsay.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://client.api.prod.orsay.ai/v1/conversation/{lead_id}/summary`
- Auth: HTTP bearer

(Re)generate the AI summary of a conversation — only on explicit user request.

## Path parameters

- `lead_id` string, uuid, required

## Request body

- GenerateConversationSummaryRequest
  - `Language` string

## Response `200`

Successful Response

- ConversationSummaryResponse
  - `Overview` string, required
  - `CurrentStatus` string, nullable
  - `InterestLevel` string, required
  - `Needs` string[]
  - `Budget` string, nullable
  - `Timeline` string, nullable
  - `QualificationAnswers` string[]
  - `Objections` string[]
  - `OpenQuestions` string[]
  - `ImportantNotes` string[]
  - `NextStep` string, nullable
  - `RecommendedActions` RecommendedActionResponse[]
    - `Type` string, required
    - `Title` string, required
    - `Reason` string, nullable
    - `Priority` string, required
    - `Timing` string, nullable
  - `Language` string, nullable
  - `GeneratedAt` string, date-time, required
  - `MessageCount` integer, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-15** `fece7e1717b5`: 1 info
  - added the optional property `RecommendedActions` to the response with the `200` status
- **2026-10-14** `18fd5f1e3eaa`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/orsay/apis/orsay-api/changes/v1/conversation/:lead_id/summary/post.md)

---

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