---
title: "List job revisions"
method: GET
path: "/jobs/{jobId}/revisions"
tags: ["jobs"]
---

# List job revisions

`GET /jobs/{jobId}/revisions`

## Request

- Base URL: `https://api.blaxel.ai/v0`
- URL: `https://api.blaxel.ai/v0/jobs/{jobId}/revisions`
- Auth: one of:
  - OAuth 2
    - Authorization code: `/oauth/authorize`
    - Client credentials
    - Token URL: `/oauth/token` scopes: `jobs:list`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/blaxel/apis/blaxel-control-plane/docs/jobs/:jobId/revisions/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns revisions for a job by name.

## Path parameters

- `jobId` string, required

## Response `200`

successful operation

- RevisionMetadata[]
  - `active` boolean: Is the revision active
  - `canary` boolean: Is the revision canary
  - `createdAt` string: Revision created at
  - `createdBy` string: Revision created by
  - `id` string: Revision ID
  - `previousActive` boolean: Is the revision previous active
  - `status` string: Status of the revision
  - `trafficPercent` integer: Percent of traffic to the revision

---

[API](https://skmtc.dev/blaxel/apis/blaxel-control-plane.md) - [All operations](https://skmtc.dev/blaxel/apis/blaxel-control-plane/llms.txt) - [OpenAPI document](https://skmtc.dev/blaxel/apis/blaxel-control-plane/revisions/dfa264bc72ee?raw)