--- title: "Get a 'summarize' job" method: GET path: "/robots/v0/jobs/summarize/{JOB_ID}" tags: ["Summarize (v0)"] deprecated: true --- # Get a 'summarize' job `GET /robots/v0/jobs/summarize/{JOB_ID}` ## Request - Base URL: `https://api.mux.com` - URL: `https://api.mux.com/robots/v0/jobs/summarize/{JOB_ID}` - Auth: one of: - HTTP basic - HTTP bearer > **Deprecated.** Deprecated: use `GET /robots/v1/jobs/summarize/{job_id}` instead. Retrieves the current status and results of a 'summarize' 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 - SummarizeJobResponseV0 - `data` SummarizeJobV0, 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` 'summarize', required - `parameters` SummarizeJobParametersV0, required - `asset_id` string, required: The Mux asset ID of the video to summarize. - `tone` 'neutral' | 'playful' | 'professional': Tone for the generated summary. "neutral" for straightforward analysis, "playful" for witty and conversational, "professional" for executive-level reporting. - `output_steering` SummarizeOutputSteeringV0: Curated output_steering controls for execution scope, summary style, audience, brand terminology, and tag taxonomy. Scope is enforced; other controls guide model behavior but do not guarantee exact output. - `scope` object: Optional execution window in seconds on the original asset timeline. Omit start_time to begin at the asset start and omit end_time to continue through the asset end. The summary and tags are generated only from media within this window. - `start_time` number: Start of the execution window in seconds from the beginning of the media. When omitted, the window starts at the beginning. - `end_time` number: End of the execution window in seconds from the beginning of the media. When omitted, the window extends to the end. - `tag_taxonomy` SummaryTagTaxonomyV0: Controlled vocabulary for tag generation. This steers tags and may be deterministically filtered after generation. Supports up to 50 values and 2000 serialized characters. - `name` string: Optional customer-facing name for the taxonomy, up to 100 characters. - `values` object[], required: Controlled vocabulary values for generated tags. Supports 1-50 values. - `label` string, required: Canonical tag value to prefer in generated tags, up to 100 characters. - `description` string: Short explanation of when this tag applies, up to 300 characters. - `aliases` string[]: Accepted alternate names that should normalize to the canonical label. Up to 10 aliases, each up to 100 characters. - `allow_other` boolean, required: When false, generated tags are filtered to taxonomy labels and aliases. When true, unmatched tags may remain. - `summary_style` 'concise' | 'detailed' | 'editorial': Best-effort style guidance for the generated title and description. - `audience` string: Intended audience used as best-effort model guidance. Does not change the output schema. - `brand_terms` string[]: Preferred brand or domain terms to use when supported by the source content. - `prompt_overrides` object: Deprecated: use `output_steering`. Raw prompt-section overrides; any section supplied here takes precedence over the equivalent `output_steering` guidance. - `task` string: Override the core task instruction for summarization. - `title` string: Override the title generation requirements. - `description` string: Override the description generation requirements. - `keywords` string: Override the keyword/tag extraction requirements. - `quality_guidelines` string: Override the quality standards for analysis. - `title_length` integer: Maximum title length in words. - `description_length` integer: Maximum description length in words. - `tag_count` integer: Maximum number of tags to include in the generated output. Defaults to 10. - `language_code` string: BCP 47 language code of the caption track to analyze (e.g. "en", "fr"). When omitted, English subtitles are preferred when available, otherwise the first ready text track is selected. - `output_language_code` string: BCP 47 language code for the generated summary output (e.g. "en", "fr", "ja"). Auto-detected from the transcript if omitted. - `update_asset_meta` boolean: When true, the generated title is written to the Mux asset's metadata (asset.meta.title) once the summary completes. Best-effort: a metadata-write failure does not fail the summary. - `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` SummarizeJobOutputsV0: Workflow results. Present when status is 'completed'. - `title` string, required: Generated title capturing the essence of the video. - `description` string, required: Generated description of the video content (typically 2-4 sentences). - `tags` string[], required: Generated keyword tags for the video. - `asset_updates` SummarizeAssetUpdateOutcomesV0: Recorded asset title update outcome. Omitted when no outcome was recorded, including historical jobs. - `title` SummarizeTitleAssetUpdateV0 - `status` 'updated' | 'failed', required: Outcome of the requested asset title update. ## 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`: 5 info - api operation id `get-summarize-job` removed and replaced with `get-summarize-job-v0` - api tag `Summarize (v0)` added - api tag `Summarize` removed - added `#/components/schemas/OutputSteeringScopeV0` to the `data/parameters/output_steering/scope` response property `allOf` list for the response status `200` - …1 more - **2026-10-08** `296f0b01bb84`: 11 info - added the non-success response with the status `422` - added the optional property `data/outputs/asset_updates` to the response with the `200` status - 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 - …7 more - **2026-10-02** `90f16ccd8b65`: 1 breaking, 2 warning, 1 info - the `data/parameters/output_steering/scope` response's property type changed from `object` to no type for status `200` - removed the optional property `data/parameters/output_steering/scope/end_time` from the response with the `200` status - removed the optional property `data/parameters/output_steering/scope/start_time` from the response with the `200` status - added `#/components/schemas/OutputSteeringScope, subschema #2` to the `data/parameters/output_steering/scope` response property `allOf` list for the response status `200` - …earlier changes not shown [Operation history](https://skmtc.dev/muxinc/apis/mux-api/changes/robots/v0/jobs/summarize/: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)