Skip to Content
Mux Docs: Home
Create an 'ask-questions' job
post

Creates a new job that uses AI to answer questions about a Mux Video asset.

Request body params
passthrough
string

Arbitrary string stored with the job and returned in responses. Useful for correlating jobs with your own systems.

parameters.asset_id
string

The Mux asset ID of the video to analyze.

One or more questions to ask about the video. Each question can specify its own answer_options.

parameters.questions[].question
string

The question to ask about the video content.

parameters.questions[].answer_options
array
(default: yes,no)

Allowed answer values for this question. Defaults to ["yes", "no"].

parameters.language_code
string

BCP 47 language code of the caption track to analyze (e.g. "en", "fr"). When omitted, the SDK uses the default track.

post
202
/robots/v0/jobs/ask-questions
Request
(application/json)
{
  "parameters": {
    "asset_id": "mux_asset_123abc",
    "questions": [
      {
        "question": "How many people are speaking on camera?",
        "answer_options": [
          "one",
          "two",
          "three or more"
        ]
      }
    ]
  }
}
Response
(application/json)
{
  "data": {
    "id": "rjob_example123",
    "workflow": "ask-questions",
    "status": "pending",
    "units_consumed": 0,
    "created_at": 1700000000,
    "updated_at": 1700000060,
    "parameters": {
      "asset_id": "mux_asset_123abc",
      "questions": [
        {
          "question": "How many people are speaking on camera?",
          "answer_options": [
            "one",
            "two",
            "three or more"
          ]
        }
      ]
    }
  }
}