---
title: "Generate Site Summary"
method: POST
path: "/site-summaries/{task_id}/generate"
tags: ["site-summaries"]
---

# Generate Site Summary

`POST /site-summaries/{task_id}/generate`

Generate or update a site summary for a specific task.

This endpoint triggers summary generation/update. It will:
1. Check if transcripts exist for the task
2. Generate a new summary or update existing one
3. Return the summary with current status

Args:
    task_id: The task ID to generate summary for
    regenerate: If True, regenerate from all transcripts. If False, use incremental update.

Returns:
    The generated or updated site summary with status

## Path parameters

- `task_id` string, required

## Query parameters

- `regenerate` boolean — Force regeneration of the summary from all transcripts

## Response `200`

Successful Response

- SiteSummaryResponse
  - `status` 'pending' | 'processing' | 'success' | 'error' | 'empty_audio', required
  - `site_summary` string, nullable
  - `message` string, nullable
  - `has_new_transcripts` boolean

## Other responses

- `404` — Not found
- `422` — Validation Error

---

[API](https://skmtc.dev/noso/apis/crucible-backend-api.md) · [All operations](https://skmtc.dev/noso/apis/crucible-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/noso/crucible-backend-api/revisions/6e257c69d1d1/schema)