Summary Templates

Overview

Summary template query API. Templates are used for the summary_template parameter of transcribe / conversation / broadcast recording types, and let you specify different summary formats (meeting, interview, medical consultation, legal consultation, etc.).

Endpoint Overview

GET /api/v1/summary-templates

Description

Retrieve the list of available summary templates, filtered by category. When you use the summary_template parameter in the WebSocket start action or the audio import API, set it to the template's slug value.

Authentication

Header: X-API-Key (see Authentication)

Request Parameters

The default summary is a backward-compatible value that returns only general summary templates and does not include the medical/legal categories.

Request Example

# General summary (default / backward compatible)
curl -X GET "https://vas-poc.vurbo.ai/api/v1/summary-templates" \
  -H "X-API-Key: vas_aB3dE5fG7hI9jK1lM3nO5pQ7rS9tU1vW"

# Medical category
curl -X GET "https://vas-poc.vurbo.ai/api/v1/summary-templates?category=medical" \
  -H "X-API-Key: vas_aB3dE5fG7hI9jK1lM3nO5pQ7rS9tU1vW"

# All categories
curl -X GET "https://vas-poc.vurbo.ai/api/v1/summary-templates?category=all" \
  -H "X-API-Key: vas_aB3dE5fG7hI9jK1lM3nO5pQ7rS9tU1vW"

Success Response

HTTP 200 (?category=all example: includes templates from all categories)

{
  "data": [
    { "slug": "general",         "name": "General Summary", "description": "Summary template for general conversations",   "category": "summary" },
    { "slug": "meeting",         "name": "Meeting Record", "description": "Meeting summary including key points, decisions, and action items", "category": "summary" },
    { "slug": "meeting_minutes", "name": "Meeting Minutes", "description": "Detailed meeting minutes template",         "category": "summary" },
    { "slug": "speech",          "name": "Speech Summary", "description": "Summary template for speech content",   "category": "summary" },
    { "slug": "interview",       "name": "Interview Summary", "description": "Summary template for interview content",   "category": "summary" },
    { "slug": "course",          "name": "Course Summary", "description": "Summary template for course content",   "category": "summary" },
    { "slug": "medical_consultation", "name": "Medical Consultation", "description": "Medical consultation record template with 19 medical fields", "category": "medical" }
  ]
}

Omitting ?category= or passing ?category=summary (default) lists only the summary category; passing ?category=medical lists only the medical category; passing ?category=all lists all categories.

Response Fields

Specific Error Codes

GET /api/v1/summary-templates/{slug}

Exposes the full source text of the three-layer Prompt of the built-in IPEVO templates, for reference during enterprise integration. If you need your own prompt rules, use the mode=custom + prompt parameters of the summary API instead (fully replacing the three layers); see POST /api/v1/summary.

Description

Retrieve the detailed content of the template with the specified slug. The response includes a three-layer Prompt:

1. System Prompt — role definition (Layer 1)
2. Template Prompt — business template rules (Layer 2)
3. Output Format — output structure (Layer 3)

When you call the summary API (mode=builtin), these three layers of the built-in template are applied automatically. If you want to use your own rules entirely (replacing the three layers), use the mode=custom + prompt path instead.

Authentication

Header: X-API-Key

Terms of Use: This endpoint exposes the source text of the built-in IPEVO templates. API Key holders are deemed to have accepted the IPEVO ToS — you may not resell, copy, or reproduce this Prompt content in any non-IPEVO service.

Request Parameters

Request Example

curl -X GET "https://vas-poc.vurbo.ai/api/v1/summary-templates/medical_consultation" \
  -H "X-API-Key: vas_aB3dE5fG7hI9jK1lM3nO5pQ7rS9tU1vW"

Success Response

HTTP 200

{
  "data": {
    "slug": "medical_consultation",
    "name": "Medical Consultation",
    "description": "Medical consultation record template",
    "category": "medical",
    "system_prompt": "You are a professional medical records specialist...",
    "template_prompt": "[Task]\nGenerate a structured summary...",
    "output_format": "[Summary Template Begin]\n## Patient Information\n..."
  }
}

Response Fields

Specific Error Codes

Related Resources

• POST /api/v1/summary — Summary generation endpoint (with customer customization parameters)
• Audio Import Guide — use the summary_template parameter when uploading audio files
• Real-Time Voice Translation Guide — use the summary_template parameter in the WebSocket start action

Version: V1.5.7 Last Updated: 2026-05-20