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

# Upload and play prerecorded audio

> Upload reusable audio assets and play them into active calls.

Upload a local audio file with multipart form field `audio`.

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.wadial.com/api/v1/call-audio-assets" \
    -H "Authorization: Bearer $WADIAL_API_KEY" \
    -F "audio=@intro.wav;type=audio/wav"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "data": {
      "id": "019f...",
      "filename": "intro.wav",
      "contentType": "audio/wav",
      "sizeBytes": 245760,
      "durationMs": null,
      "status": "ready"
    }
  }
  ```
</ResponseExample>

## List assets

```http theme={null}
GET /api/v1/call-audio-assets
Authorization: Bearer <api_key>
```

## Delete an asset

```http theme={null}
DELETE /api/v1/call-audio-assets/{assetId}
Authorization: Bearer <api_key>
```

## Play an asset

```http theme={null}
POST /api/v1/sessions/{sessionId}/calls/{callId}/audio/play
Authorization: Bearer <api_key>
Content-Type: application/json
```

```json theme={null}
{
  "assetId": "019f..."
}
```

Remote audio URLs are not accepted for this feature. Upload assets first so playback cannot be used to fetch arbitrary private URLs.