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

# Upload Recordings

> Upload a recording file (zip, mp3 or wav) for evaluation. Progress is streamed back as server-sent events (started, processing, completed, error).

Upload a recording file for evaluation. The response is streamed as server-sent events so you can follow the upload progress.

## Endpoint

**POST** `/evaluation/upload-recordings`

**Content-Type:** `multipart/form-data`
**Authentication:** API token in the `token` header.

## Form Data

| Field | Type | Required | Description |
| - | - | - | - |
| `file` | file | Yes | Recording file. Allowed types: zip, mp3, wav. |

## Response

The response is a `text/event-stream`. Each event is a JSON object:

```json theme={null}
{ "status": "started", "percentage": 0, "message": "Upload started" }
{ "status": "processing", "percentage": 50, "message": "File uploaded successfully", "totalRecordings": 1 }
{ "status": "completed", "percentage": 100, "message": "Recordings uploaded successfully", "summary": {} }
```

On failure an event with `"status": "error"` and a `message` is sent.

## Error Cases

| Error | Cause |
| - | - |
| `No files uploaded` | The request has no `file` |
| `Invalid file type. Allowed: zip, mp3, wav` | Unsupported file type |

## Example cURL

```bash theme={null}
curl -N -X POST https://dev.tryunleashx.com/api/v1/global/evaluation/upload-recordings \
  -H "token: <api_key>" \
  -F "file=@recordings.zip"
```


## OpenAPI

````yaml api-reference/openapi.json POST /evaluation/upload-recordings
openapi: 3.1.0
info:
  title: >-
    UnleashX - Build human like conversations | Voice Agents | Automations | AI
    Workforce
  version: 1.0.0
  description: UnleashX - Your home for human like conversations
servers:
  - url: https://www.tryunleashx.com/api/v1/global/
security:
  - bearerAuth: []
paths:
  /evaluation/upload-recordings:
    post:
      tags:
        - Evaluation
      summary: Upload Recordings
      description: >-
        Upload a recording file (zip, mp3 or wav) for evaluation. Progress is
        streamed back as server-sent events (started, processing, completed,
        error).
      parameters:
        - name: token
          in: header
          required: true
          description: API token for authentication
          schema:
            type: string
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              required:
                - file
              properties:
                file:
                  type: string
                  format: binary
                  description: 'Recording file: zip, mp3 or wav'
      responses:
        '200':
          description: Server-sent event stream with upload progress
          content:
            text/event-stream:
              schema:
                type: string
      security: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.