Sign in
AI

Regenerate an ai summary.

Regenerates the content of an existing ai summary in place, keeping the same summary ID. Unlike creating a new summary, this always re-runs the summary generation for the referenced resource (bypassing the create-path deduplication), so an explicit Regenerate reliably produces fresh content. Optionally re-select the output language: when a different language is supplied the existing summary is replaced with the new-language summary on the same record (one summary per recording is kept); when language is omitted the existing summary's language is preserved. Regeneration runs the content generation first and only overwrites the record on success, so a failed regeneration leaves the existing content intact. Supported only for summaries whose reference_type is recording.

post/aisummaries/{id}/regenerate

Path parameters

idstring uuid required
Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890

The ID of the ai summary to regenerate. Returned from GET /aisummaries.

Request body

languagestring

BCP47 language code for the regenerated summary output (e.g., en-US, ko-KR). Controls only the language the summary is written in; it is independent of the transcription (STT) language. When omitted the existing summary's language is preserved; when a different value is supplied the summary is replaced with the new-language summary on the same record.

Response

Details of the regenerated ai summary.

idstring uuid

The unique identifier of the summary.

customer_idstring uuid

The unique identifier of the associated customer. Returned from the GET /customers response.

activeflow_idstring uuid

The unique identifier of the activeflow. Returned from the GET /activeflows response.

on_end_flow_idstring uuid

The unique identifier of the flow to execute when the summary completes. Returned from the POST /flows or GET /flows response.

reference_type'' | 'call' | 'conference' | 'transcribe' | 'recording'

Type of reference for the AI summary.

reference_idstring uuid

The unique identifier of the referenced resource. The actual resource type is determined by reference_type. Returned from the corresponding resource endpoint.

status'' | 'progressing' | 'done'

Status of the AI summary generation.

languagestring

BCP47 language code for the summary output (e.g., en-US, ko-KR). This controls only the language the summary is written in; it is independent of the transcription (STT) language. The server reuses an existing transcription when available and translates the summary into this output language.

contentstring

Content of the summary.

tm_createstring date-time

Timestamp when the summary was created.

tm_updatestring date-time

Timestamp when the summary was last updated.

tm_deletestring date-time

Timestamp when the summary was deleted.

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "customer_id": "7c4d2f3a-1b8e-4f5c-9a6d-3e2f1a0b4c5d",
  "activeflow_id": "550e8400-e29b-41d4-a716-446655440000",
  "on_end_flow_id": "550e8400-e29b-41d4-a716-446655440000",
  "reference_type": "call",
  "reference_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "progressing",
  "language": "en-US",
  "content": "The customer called to inquire about their account balance and was assisted by the support agent.",
  "tm_create": "2026-01-15T09:30:00.000000Z",
  "tm_update": "2026-01-15T09:30:00.000000Z",
  "tm_delete": "2026-01-15T09:30:00.000000Z"
}

Changes

Changed in 1 of the 97 revisions of this API.1