Skip to Content
Get a 'find-best-thumbnails' job
get

Retrieves the current status and results of a 'find-best-thumbnails' job. Jobs are automatically deleted after 30 days.

Request path & query params
JOB_ID
string

Robots job ID returned by job creation or listing (rjob_...).. Robots job ID returned by job creation or listing (rjob_...).

get
200
https://api.mux.com/robots/v0/jobs/find-best-thumbnails/{JOB_ID}
Response
(application/json)
{
  "data": {
    "id": "rjob_example123",
    "workflow": "find-best-thumbnails",
    "status": "completed",
    "units_consumed": 1,
    "created_at": 1700000000,
    "updated_at": 1700000060,
    "parameters": {
      "asset_id": "mux_asset_123abc",
      "max_thumbnails": 3,
      "update_asset_thumbnail": true,
      "output_steering": {
        "scope": {
          "start_time": 30,
          "end_time": 180
        },
        "selection_strategy": "campaign_thumbnail",
        "scoring_priorities": [
          "composition",
          "brand_fit"
        ]
      }
    },
    "outputs": {
      "best_thumbnails": [
        {
          "timestamp_ms": 23000,
          "subscores": {
            "focus": 0.9,
            "face_or_action": 0.8,
            "composition": 0.9,
            "contrast_color": 0.8,
            "brand_fit": 0.7
          },
          "overall": 0.82,
          "description": "A presenter demonstrating the product against a clear background.",
          "alt_text": "Presenter holding the product toward the camera."
        }
      ],
      "asset_updates": {
        "thumbnail": {
          "status": "updated"
        }
      }
    }
  }
}