Skip to main content
POST
/
v1
/
summaries
/
{id}
/
regenerate
curl -X POST https://api.mavioapp.com/v1/summaries/sum_1g2h3i4j5k6l/regenerate \
  -H "Authorization: Bearer mvo_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "narrative",
    "language": "es",
    "detail_level": "detailed"
  }'

{
  "id": "sum_1g2h3i4j5k6l",
  "meeting_id": "mtg_8f3k2j1m4n5p",
  "status": "processing",
  "format": "narrative",
  "language": "es",
  "detail_level": "detailed",
  "estimated_seconds": 15
}

Documentation Index

Fetch the complete documentation index at: https://docs.mavioapp.com/llms.txt

Use this file to discover all available pages before exploring further.

Triggers a new AI-generated summary for an existing meeting. The previous summary is replaced once the new one is ready. Use this to change the format, language, or level of detail. This endpoint has an additional rate limit of 10 requests per minute. See rate limits.
​
id
string
required
The unique summary identifier (e.g., sum_1g2h3i4j5k6l).

​
Request body

​
format
string
default:"structured"
The output format for the summary:
  • structured — Organized sections (overview, agenda, decisions, action items, key points).
  • narrative — A flowing paragraph-style summary.
  • bullet_points — Concise bullet-point list of key takeaways.
​
language
string
Generate the summary in a different language. ISO 639-1 code (e.g., es for Spanish, fr for French, ja for Japanese). Defaults to the original transcript language.
​
detail_level
string
default:"standard"
Level of detail in the summary:
  • brief — 3-5 sentence overview with only the most critical items.
  • standard — Balanced summary covering all major topics and decisions.
  • detailed — Comprehensive summary with granular topic breakdowns and full context.
​
focus_topics
array
Optional array of topic strings to emphasize in the summary (e.g., ["budget", "timeline"]). The AI will give these topics extra attention and detail.

​
Response

​
id
string
The summary identifier (same as the input).
​
meeting_id
string
The ID of the associated meeting.
​
status
string
Processing status: processing immediately after the request, completed when done.
​
format
string
The requested format.
​
language
string
The requested language.
​
detail_level
string
The requested detail level.
​
estimated_seconds
integer
Estimated time until the new summary is ready, in seconds.
curl -X POST https://api.mavioapp.com/v1/summaries/sum_1g2h3i4j5k6l/regenerate \
  -H "Authorization: Bearer mvo_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "narrative",
    "language": "es",
    "detail_level": "detailed"
  }'

{
  "id": "sum_1g2h3i4j5k6l",
  "meeting_id": "mtg_8f3k2j1m4n5p",
  "status": "processing",
  "format": "narrative",
  "language": "es",
  "detail_level": "detailed",
  "estimated_seconds": 15
}
Regeneration is asynchronous. Poll the Get summary endpoint to check when the new summary is ready, or subscribe to the summary.ready webhook event for real-time notification.
Use focus_topics when you need the summary to emphasize specific areas. For example, after a board meeting you might pass ["financials", "hiring"] to get a summary that prioritizes those discussions.