--- title: "Get a 'find-key-moments' job" method: GET path: "/robots/v0/jobs/find-key-moments/{JOB_ID}" tags: ["Find Key Moments (v0)"] deprecated: true --- # Get a 'find-key-moments' job `GET /robots/v0/jobs/find-key-moments/{JOB_ID}` ## Request - Base URL: `https://api.mux.com` - URL: `https://api.mux.com/robots/v0/jobs/find-key-moments/{JOB_ID}` - Auth: one of: - HTTP basic - HTTP bearer > **Deprecated.** Deprecated: use `GET /robots/v1/jobs/find-key-moments/{job_id}` instead. Retrieves the current status and results of a 'find-key-moments' 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 - FindKeyMomentsJobResponseV0 - `data` FindKeyMomentsJobV0, 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` 'find-key-moments', required - `parameters` FindKeyMomentsJobParametersV0, required - `asset_id` string, required: The Mux asset ID of the video to analyze. - `max_moments` integer: Maximum number of key moments to extract. When omitted, defaults to 10 for assets up to one hour and 25 for longer assets. - `target_duration_ms` object: Preferred highlight duration range in milliseconds. When provided, the model will aim to select moments within this range. - `min` integer, required: Preferred minimum highlight duration in milliseconds. - `max` integer, required: Preferred maximum highlight duration in milliseconds. - `use_shots` boolean: Controls whether video assets are analyzed using Mux shots. When true, shots are generated or reused and visual evidence drives selection. When false or omitted, selection uses transcript evidence and the asset must have a caption track. Not supported for audio-only assets. - `output_steering` FindKeyMomentsOutputSteeringV0: Curated output_steering controls for execution scope, selection strategy, title style, audience, taxonomy, and rubric tie-breakers. 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. Returned moment timestamps remain absolute asset timestamps. - `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. - `selection_strategy` 'standalone_hooks' | 'educational_takeaways' | 'story_beats' | 'product_moments' | 'speaker_highlights': Best-effort guidance for what qualifies as a strong standalone key moment. - `title_style` 'descriptive' | 'punchy' | 'educational' | 'social': Best-effort title style guidance for generated moment titles. - `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. - `topic_taxonomy` object: Controlled vocabulary used to steer notable audible concepts without changing the response schema. - `name` string: Optional customer-facing name for the taxonomy. - `values` OutputSteeringTaxonomyValueV0[], required: Controlled vocabulary values used as best-effort model guidance. - `label` string, required: Canonical taxonomy value to prefer when supported by the source content. - `description` string: Short explanation of when this value applies. - `aliases` string[]: Accepted alternate names that should normalize to the canonical label. - `allow_other` boolean, required: When false, the model should prefer values from the taxonomy. When true, non-taxonomy values may be used when no taxonomy value applies. - `rubric_priorities` KeyMomentsRubricPriorityV0[]: Rubric dimensions to use as tie-breakers after applying selection strategy. Best-effort guidance only. - `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` FindKeyMomentsJobOutputsV0: Workflow results. Present when status is 'completed'. - `moments` object[], required: Extracted key moments, ordered by their absolute position on the original asset timeline. - `start_ms` number, required: Moment start time in milliseconds. - `end_ms` number, required: Moment end time in milliseconds. - `cues` object[], required: Contiguous transcript segments that comprise this moment. Empty when video selection identifies the moment without transcript evidence. - `start_ms` number, required: Cue start time in milliseconds. - `end_ms` number, required: Cue end time in milliseconds. - `text` string, required: Transcript text for this cue. - `overall_score` number, required: Weighted quality score from 0.0 to 1.0 based on the audible and/or visual evidence available to the selected analysis mode. - `title` string, required: Short catchy title for the moment (3-8 words). - `quotable_segment` KeyMomentQuotableSegmentV0: Best short, verbatim quote from within this moment. Omitted when the selected video moment has no source-grounded transcript quote. - `start_ms` number, required: Quote segment start time in milliseconds. - `text` string, required: Verbatim transcript quote selected from within the key moment. - `audible_narrative` string, required: One-sentence summary of what is being said during the moment. Empty when no transcript evidence is available. - `notable_audible_concepts` string[], required: Multi-word descriptive phrases (2-5 words each) capturing key audible concepts. Empty when no transcript evidence is available. - `visual_narrative` string: One-sentence summary of what is visually happening. Present for video assets only. - `notable_visual_concepts` object[]: Scored visual concepts extracted from sampled frames. Present for video assets only. - `concept` string, required: Multi-word visual concept (2-5 words). - `score` number, required: Relevance score from 0.0 to 1.0 measuring how important the visual concept is to the moment's available evidence. - `rationale` string, required: Brief explanation of the relevance score. ## 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`: 7 info - api operation id `get-find-key-moments-job` removed and replaced with `get-find-key-moments-job-v0` - api tag `Find Key Moments (v0)` added - api tag `Find Key Moments` removed - added `#/components/schemas/OutputSteeringScopeV0` to the `data/parameters/output_steering/scope` response property `allOf` list for the response status `200` - …3 more - **2026-10-08** `296f0b01bb84`: 9 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 - …5 more - **2026-08-12** `5b4b3133f27d`: 4 breaking, 5 info - the `data/parameters/max_moments` response property's max was increased from `10.00` to `25.00` for the response status `200` - the `data/outputs/moments/items/cues` response property's minItems was decreased from `1` to `0` for the response status `200` - the `data/outputs/moments/items/notable_audible_concepts` response property's minItems was decreased from `1` to `0` for the response status `200` - the `data/outputs/moments/items/audible_narrative` response property's minLength was decreased from `1` to `0` for the response status `200` - …5 more - …earlier changes not shown [Operation history](https://skmtc.dev/muxinc/apis/mux-api/changes/robots/v0/jobs/find-key-moments/: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)