Prepare a WAV media asset | Voice Platform

Fetch and validate a WAV source asynchronously. Retry with the same Idempotency-Key and body to receive the same asset.

Authentication

AuthorizationBearer

Application auth. Send Authorization: Bearer <app_uuid>:<api_key> using any active key in the app’s collection. See Authentication for details.

Application auth. Send `Authorization: Bearer <app_uuid>:<api_key>` using any active key in the app's collection. See [Authentication](https://voice-platform.docs.buildwithfern.com/api/authentication) for details.

Request

This endpoint expects an object.

source_urlstringRequiredformat: "uri"

Public HTTP or HTTPS URL of the WAV file to prepare.

ttl_secondsintegerOptional1-604800

Optional asset lifetime in seconds. The service default applies when omitted.

Response

Asset accepted or replayed

asset_idstringformat: "^[0-9a-f]{32}$"

created_atdatetime

statusenum

duration_msintegerOptional

expires_atdatetimeOptional

failure_reasonstringOptional

formatobjectOptional

size_bytesintegerOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

413

Content Too Large Error

500

Internal Server Error

503

Service Unavailable Error

$	curl -X POST https://api.telekesher.dev/api/v1/media/assets \
>	-H "Idempotency-Key: Idempotency-Key" \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"source_url": "https://cdn.example.com/prompt.wav",
>	"ttl_seconds": 3600
>	}'

1	{
2	"asset_id": "0123456789abcdef0123456789abcdef",
3	"created_at": "2026-08-17T00:00:00Z",
4	"status": "preparing",
5	"expires_at": "2026-08-18T00:00:00Z"
6	}

Authentication

Headers

Request

Response

Errors