POST Webhook robots.job.find_best_thumbnails.pending

Payload

type'robots.job.find_best_thumbnails.pending' required

Type for the webhook event

idstring required

Unique identifier for the event

created_atstring date-time required

Time the event was created

Example payload

{
  "created_at": "2022-01-01T00:00:00.000000Z",
  "attempts": [
    {
      "created_at": "2022-01-01T00:00:00.000000Z"
    }
  ],
  "data": {
    "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"
        ]
      }
    },
    "resources": {
      "assets": [
        {
          "id": "abc123asset",
          "meta": {
            "title": "My Video",
            "creator_id": "user123",
            "external_id": "ext456"
          },
          "_links": {
            "self": {
              "href": "/video/v1/assets/abc123asset"
            }
          }
        }
      ]
    },
    "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"
        }
      }
    }
  }
}

Response

Return a 200 to indicate that the data was received successfully

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.