Jobs

Returns a paginated list of Robots jobs, with optional filters for workflow, status, and asset_id. Jobs are automatically deleted after 30 days.

get/robots/v1/jobs

Request

  • Base URL
    https://api.mux.com
  • Auth
    • HTTP basic
    • or HTTP bearer

Query parameters

workflow'analyze-structure' | 'summarize' | 'generate-contextual-text' | 'moderate' | 'generate-chapters' | 'edit-captions' | 'translate-captions' | 'translate-audio' | 'ask-questions' | 'find-key-moments' | 'generate-engagement-insights' | 'generate-premium-captions' | 'find-best-thumbnails'

Filter by workflow name

status'pending' | 'processing' | 'completed' | 'errored' | 'cancelled'

Filter by job status

asset_idstring

Filter by Mux asset ID

limitinteger

Maximum number of jobs to return (default 25, max 100)

pageinteger

Page number (default 1)

Response

List of jobs

total_row_countinteger required

Total number of jobs matching the query filters

Example response

{
  "total_row_count": 42
}

Changes