--- title: "Get a 'translate-audio' job" method: GET path: "/robots/v0/jobs/translate-audio/{JOB_ID}" tags: ["Translate Audio (v0)"] deprecated: true --- # Get a 'translate-audio' job `GET /robots/v0/jobs/translate-audio/{JOB_ID}` ## Request - Base URL: `https://api.mux.com` - URL: `https://api.mux.com/robots/v0/jobs/translate-audio/{JOB_ID}` - Auth: one of: - HTTP basic - HTTP bearer > **Deprecated.** Deprecated: use `GET /robots/v1/jobs/translate-audio/{job_id}` instead. Retrieves the current status and results of a 'translate-audio' job. Jobs are automatically deleted after 30 days. ## Path parameters - `JOB_ID` string, required: Robots job ID returned by job creation or listing (rjob_...). ## Response `200` Current status for the requested job - TranslateAudioJobResponseV0 - `data` TranslateAudioJobV0, required - `id` string, required: Unique job identifier. - `passthrough` string: Arbitrary string supplied at creation, returned as-is. - `units_consumed` integer, required: Number of Mux AI units consumed by this job. - `directive` JobDirectiveContextV0: The directive run that dispatched this job. Absent for jobs created via direct API POST. - `id` string, required: ID of the directive that dispatched this job. - `run_id` string, required: ID of the specific directive run that dispatched this job. - `created_at` integer, required: Unix timestamp (seconds) when the job was created. - `updated_at` integer, required: Unix timestamp (seconds) of the job's last state transition (e.g. when it started processing or reached a terminal state). - `workflow` 'translate-audio', required - `parameters` TranslateAudioJobParametersV0, required - `asset_id` string, required: The Mux asset ID of the video to translate. - `to_language_code` string, required: BCP 47 language tag for the target audio (e.g. "es", "ur", "yue"). See [supported languages](https://www.mux.com/docs/guides/robots-supported-languages#translate-audio). Known ISO 639-3 aliases are accepted. Region and script subtags are retained on Mux tracks, but dubbing uses the base language. - `track_name` string: Name for the dubbed Mux audio track. Defaults to "{Language} (Auto-dubbed)", e.g. "Spanish (Auto-dubbed)". Mux requires audio track names to be unique on an asset, and an existing track with this name is handled according to `replace_existing_tracks`. - `upload_to_mux` boolean: Whether to automatically upload the translated audio track to the Mux asset. Defaults to true. Must be false for audio-only assets; the job returns downloadable audio instead. - `replace_existing_tracks` 'fail' | 'replace_all' | 'replace_generated': What to do when the asset already has an audio track in the same language as, or with the same name as, the new dubbed track. Defaults to `fail`, which rejects the request before any dubbing is billed. `replace_all` deletes every such track first. Audio tracks are never auto-generated by Mux Video, so `replace_generated` behaves as `fail` here. The asset's primary audio track is never deleted. Any value other than `fail` requires `upload_to_mux` to be true. Existing tracks are matched by language ignoring region subtags, and by name ignoring case, in any status. - `status` 'pending' | 'processing' | 'completed' | 'errored' | 'cancelled', required: Current job status. - `errors` JobErrorV0[]: Error details. Present when status is 'errored'. - `type` string, required: Stable public error category identifier. - `message` string, required: Human-readable public error message. - `retryable` boolean: Whether retrying this job may resolve the error. - `resources` ResourcesV0: Related Mux resources linked to this job. - `assets` SlimlineAssetV0[], required: Mux assets associated with this job. - `id` string, required: Mux asset ID. - `meta` object: Mux asset metadata, if available. - `title` string: Asset title from Mux metadata. - `creator_id` string: Creator identifier from Mux metadata. - `external_id` string: External identifier from Mux metadata. - `passthrough` string: Passthrough string from the Mux asset. - `_links` object, required: Hypermedia links for the asset. - `self` object, required - `href` string, required: URL to the Mux asset resource. - `outputs` TranslateAudioJobOutputsV0: Workflow results. Present when status is 'completed'. - `uploaded_track_id` string: Mux audio track ID, present when upload_to_mux is true. - `temporary_audio_url` string: Temporary pre-signed URL to download the dubbed audio with the FLAC output format. Expires 7 days after the job completes. - `replaced_tracks` ReplacedTrackV0[]: Every track deleted before the new track was created. Present when `replace_existing_tracks` was a deleting policy and at least one track was removed. - `id` string, required: Mux track ID of the deleted track. - `type` 'text' | 'audio': Mux track type of the deleted track. - `name` string: Name of the deleted track. - `language_code` string: Language code of the deleted track. - `text_source` string: Mux `text_source` of the deleted track, e.g. `uploaded` or `generated_vod`. Absent for audio tracks. - `passthrough` string: `passthrough` value the deleted track carried, if any. ## Other responses - `401`: Missing or invalid Mux credentials - `403`: Robots is not enabled for this environment. Accept the Robots beta terms in the Mux Dashboard to enable access. - `404`: No job exists for the supplied id - `422`: Invalid job ID - `500`: Server error ## Changes - **2026-10-26** `151835caff06`: 1 info - endpoint deprecated - **2026-10-19** `7e2e5079412d`: 3 info - api operation id `get-translate-audio-job` removed and replaced with `get-translate-audio-job-v0` - api tag `Translate Audio (v0)` added - api tag `Translate Audio` removed - **2026-10-08** `296f0b01bb84`: 10 info - added the non-success response with the status `422` - added the optional property `error/messages` to the response with the `401` status - added the optional property `error/messages` to the response with the `403` status - added the optional property `error/messages` to the response with the `404` status - …6 more - **2026-10-02** `90f16ccd8b65`: 1 info - added the optional property `data/parameters/track_name` to the response with the `200` status - **2026-09-28** `b57bb059a052`: 2 info - added the optional property `data/outputs/replaced_tracks` to the response with the `200` status - added the optional property `data/parameters/replace_existing_tracks` to the response with the `200` status [Operation history](https://skmtc.dev/muxinc/apis/mux-api/changes/robots/v0/jobs/translate-audio/:JOB_ID/get.md) --- [API](https://skmtc.dev/muxinc/apis/mux-api.md) - [All operations](https://skmtc.dev/muxinc/apis/mux-api/llms.txt) - [OpenAPI document](https://skmtc.dev/muxinc/apis/mux-api/revisions/75b4251a1d96?raw)