---
title: "Create Voice File Job"
method: POST
path: "/v1/external/voice-file/jobs"
tags: ["Voice File"]
---

# Create Voice File Job

`POST /v1/external/voice-file/jobs`

Create a new Voice File Job for audio transcription and optional translation.

- Returns a presigned upload URI for your audio file
- Optionally specify source language hints and target translation locales
- Job starts in `CREATED` status — upload your file to begin processing
- Requires a user or system API key bound to a workspace where Voice File Jobs are enabled

Documentation: [Complete workflow guide with code examples](/voice-file/tutorial)

## Request body

- object
  - `transcriptLocaleHints` string[] — Locale hints for transcription. - Maximum 1 locale - If omitted, language is auto-detected from audio content
  - `translationLocales` string[] — Optional locales for translation (max 5)

## Response `201`

Job created successfully

- VoiceFileJobCreated — Response returned when a new Voice File Job is created. Contains the job ID and a presigned URL for uploading the audio file. **Next Steps:** 1. Upload your audio file to `uploadUri` using HTTP PUT 2. Call `PUT /v1/external/voice-file/jobs/{id}/upload-complete` to start processing
  - `id` string, required — Unique job identifier (UUID format). Use this ID in subsequent API calls.
  - `uploadUri` string, uri, required — Presigned URL for uploading the audio file. - Use HTTP PUT method to upload - URL expires in 1 hour - Set appropriate Content-Type header (e.g., audio/mpeg, audio/wav)

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — `403000 forbidden` when the key is not workspace-bound or the workspace policy is disabled. Bind the key to an enabled workspace or ask a Tiro administrator to enable Voice File Jobs. `403013 forbidden` when the key lacks `voice_file_job:write`. Reissue the key with the required scope.

---

[API](https://skmtc.net/tiro/apis/tiro-api.md) · [All operations](https://skmtc.net/tiro/apis/tiro-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tiro/tiro-api/revisions/ae18d7961aa4/schema)