Skip to main content
POST
Create voice audio upload

Authorizations

Authorization
string
header
required

Send your team API key or project token as Authorization: Bearer <token>. The credential must have the required permissions. Project tokens can access only their own project.

Body

application/json
name
string
required

Human-readable name for this resource.

Value constraints

Required string length: 1 - 100
contentType
enum<string>
required

IANA media type that matches the payload.

Allowed values

Value constraints

Available options:
audio/mpeg,
audio/wav,
audio/x-wav,
audio/ogg,
audio/mp4,
audio/x-m4a
sizeBytes
integer
required

File size in bytes, at most 16 MB.

Value constraints

Required range: 1 <= x <= 16777216
projectId
string<uuid>

Project that owns the asset. Required for organization keys.

Value constraints

retentionDays
integer

Delete the asset automatically this many days after creation (1 to 3650). Omit to keep it until you delete it.

Value constraints

Required range: 1 <= x <= 3650

Response

Asset created in pending_upload, with the upload URL.

success
enum<boolean>
required

Whether the request succeeded.

Allowed values

Available options:
true
data
object
required

Structured data carried by this object.