Skip to main content
POST
/
summaries
curl -X POST https://api.bota.dev/v1/summaries \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "transcription_id": "txn_abc123",
    "template": "sales"
  }'

{
  "id": "sum_abc123",
  "transcription_id": "txn_abc123",
  "status": "pending",
  "template": "sales",
  "output": null,
  "error": null,
  "created_at": "2025-01-15T10:10:00Z",
  "completed_at": null
}
Generate a structured summary from a completed transcription using built-in templates. The transcription must be in completed status. Use webhooks to receive real-time notifications when the summary completes, or poll the Get Summary endpoint.
​
transcription_id
string
required
The transcription’s unique identifier (e.g., txn_abc123). Must be in completed status.
​
template
string
required
Summary template to use. One of: general, sales, clinical, legal.

​
Templates

Bota provides four built-in templates optimized for different use cases:
TemplateTarget IndustryOutput Format
generalGeneral meetingsKey points, action items, participants, decisions, overview
salesSales callsPain points, budget, timeline, next steps, sentiment, deal probability
clinicalHealthcareSOAP notes (Subjective, Objective, Assessment, Plan)
legalLegal consultationsFacts, issues, analysis, conclusion, parties involved
See Summary Templates for detailed output schemas. 
curl -X POST https://api.bota.dev/v1/summaries \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "transcription_id": "txn_abc123",
    "template": "sales"
  }'

{
  "id": "sum_abc123",
  "transcription_id": "txn_abc123",
  "status": "pending",
  "template": "sales",
  "output": null,
  "error": null,
  "created_at": "2025-01-15T10:10:00Z",
  "completed_at": null
}

​
Summary Status

StatusDescription
pendingJob queued, waiting to start
processingSummary generation in progress
completedSummary generated successfully
failedSummary generation failed (check error field)
For production use, subscribe to webhook events instead of polling: See Webhooks Overview for setup instructions.
Summary generation typically takes 5-15 seconds, depending on transcript length and template complexity.