---
title: "List jobs"
method: GET
path: "/robots/v1/jobs"
tags: ["Jobs"]
---

# List jobs

`GET /robots/v1/jobs`

## Request

- Base URL: `https://api.mux.com`
- URL: `https://api.mux.com/robots/v1/jobs`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

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

## 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_id` string: Filter by Mux asset ID
- `limit` integer: Maximum number of jobs to return (default 25, max 100)
- `page` integer: Page number (default 1)

## Response `200`

List of jobs

- ListJobsResponse
  - `data` JobSummary[], required
    - `id` string, required: Unique job identifier.
    - `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', required: Workflow type that created this job.
    - `status` 'pending' | 'processing' | 'completed' | 'errored' | 'cancelled', required: Current job status.
    - `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).
    - `_links` object, required: Hypermedia links for this job.
      - `self` object, required
        - `href` string, required: URL to this resource.
  - `total_row_count` integer, required: Total number of jobs matching the query filters

## Other responses

- `401`: Missing or invalid Mux credentials
- `403`: The access token lacks robots:read (insufficient_scope), or Robots access is inactive or suspended. For insufficient_scope, use credentials with the required permission. If using an API access token, create a replacement token with that permission. Enabling Robots for an organization does not grant token permissions.
- `422`: Invalid request parameters
- `500`: Server error

## Changes

- **2026-10-23** `ed6cb570d60c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/muxinc/apis/mux-api/changes/robots/v1/jobs/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)