---
title: "Generate Executive Summary"
method: POST
path: "/api/debrief/generate-summary"
tags: ["debrief"]
---

# Generate Executive Summary

`POST /api/debrief/generate-summary`

## Request

- Base URL: `https://api.thebetterhire.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.thebetterhire.ai/api/debrief/generate-summary`
- Auth: none declared

Generate AI executive summary for a debrief report

Args:
    request: ExecutiveSummaryRequest with aggregated interview data

Returns:
    ExecutiveSummaryResponse with the generated summary

## Request body

- ExecutiveSummaryRequest: Request model for generating executive summary
  - `candidate_name` string, required
  - `job_role` string, required
  - `overall_score` integer, required
  - `consensus_recommendation` string, required
  - `total_rounds` integer, required
  - `round_summaries` RoundSummary[], required
    - `round` string, required
    - `score` integer, required
    - `recommendation` string, required
    - `date` string, nullable
  - `top_strengths` StrengthConcern[], required
    - `text` string, required
    - `frequency` integer, required
  - `key_concerns` StrengthConcern[], required
    - `text` string, required
    - `frequency` integer, required
  - `competency_averages` CompetencyAverageInput[], required
    - `name` string, required
    - `average` number, required
  - `communication_trend` string, nullable

## Response `200`

Successful Response

- ExecutiveSummaryResponse: Response model for executive summary
  - `executive_brief` string, required
  - `generated_at` string, required
  - `provider` string, required
  - `tokens_used` integer, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api.md) · [All operations](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/revisions/c8ad03e900ea?raw)