API ReferenceBatch Transcribe

Upload Batch Manifest File

Upload a batch manifest containing audio URLs for standard mode batch processing. **Workflow:** 1. Upload your manifest here to get a `batch_file_id` 2. Use that ID in [Create Batch Transcription](/api-reference/batch-transcribe/create-batch-transcription) with `processing_mode: "standard"` The manifest is a list of audio sources (max 500), each with a URL and optional title. You can provide it as a JSON array or JSONL format.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
content_typeenumRequired
Format of your manifest data
Allowed values:
json_itemslist of objectsOptional

For JSON format. Array of audio sources to transcribe (max 500).

jsonlstringOptional

For JSONL format. One audio source per line as JSON, separated by newlines (max 500 lines).

Example: {"audio_url": "https://..."}\n{"audio_url": "https://..."}

metadataobjectOptional
Optional title and description for this manifest

Response

This endpoint returns an object.
batch_file_idUUID

Use this ID when calling Create Batch Transcription with standard mode

item_countinteger
Number of audio sources in the manifest
size_bytesinteger
Size of the manifest in bytes
created_atdatetime
Upload timestamp
statusenum

Validation status. Wait for VALID before starting a batch.

Allowed values:
checksumstring or null
SHA256 checksum of the manifest
validation_errorslist of strings or null

If status is INVALID, lists what’s wrong with the manifest

Errors