> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vatis.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Summarization

> Extract the essentials from your content

Configure the summary with the following options:

<ParamField query="summary" type="bool" default="false">
  Create a summary based on the upstream content.
</ParamField>

<ParamField query="summaryLength" type="string" default="brief">
  Summary length. Options are: `brief` or `detailed`.
</ParamField>

<ParamField query="summaryTone" type="string" default="conversational">
  Summary tone. Options are: `conversational` or `informative`.
</ParamField>

<ParamField query="summaryStructure" type="string" default="paragraphs">
  Summary structure. Options are: `paragraphs` or `bullet_points`.
</ParamField>

## Usage

```bash theme={null}
curl -X 'POST' \
  'https://http-gateway.vatis.tech/http-gateway/api/v1/upload?streamConfigurationTemplateId=668115d123bca7e3509723d4&summary=true&summaryTone=informative&persist=true' \
  -H 'accept: application/json' \
  -H 'Authorization: Basic <api_key>' \
  -H 'Content-Type: application/octet-stream' \
  --data-binary '@test.wav'
```

## Export Response

```json theme={null}
{
  ...
  "summary": {
    "content": "A customer named George Washington contacted *** to sign up for Wi-Fi service. During the call, he provided his phone number..."
  }
}
```