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

# List jobs

`GET /robots/v0/jobs`

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` 'summarize' | 'moderate' | 'generate-chapters' | 'edit-captions' | 'translate-captions' | 'ask-questions' | 'find-key-moments' — 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` 'summarize' | 'moderate' | 'generate-chapters' | 'edit-captions' | 'translate-captions' | 'ask-questions' | 'find-key-moments', 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) when the job was last updated.
    - `_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

- `403` — Robots is not enabled for this environment. Accept the Robots beta terms in the Mux Dashboard to enable access.
- `500` — Server error

---

[API](https://skmtc.net/muxinc/apis/mux-api.md) · [All operations](https://skmtc.net/muxinc/apis/mux-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/muxinc/mux-api/revisions/34a65dce0f31/schema)