---
title: "Retrieve runtime revision"
method: GET
path: "/v1/runtimes/{runtime_id}/revisions/{revision_id}"
tags: ["Runtime"]
---

# Retrieve runtime revision

`GET /v1/runtimes/{runtime_id}/revisions/{revision_id}`

## Request

- Base URL: `https://api.riza.io`
- URL: `https://api.riza.io/v1/runtimes/{runtime_id}/revisions/{revision_id}`
- Auth: HTTP bearer

Retrieves a runtime revision.

## Path parameters

- `runtime_id` string, required
- `revision_id` string, required

## Response `200`

OK

- RuntimeRevision
  - `additional_python_imports` string
  - `id` string, required
  - `manifest_file` ManifestFile, required
    - `contents` string, required
    - `name` 'requirements.txt' | 'package.json', required
  - `runtime_id` string, required
  - `status` 'pending' | 'building' | 'succeeded' | 'failed' | 'cancelled', required

## Other responses

- `401`: Unauthenticated error response

## Changes

- **2025-03-19** `45af77c4f3bd`: 1 info
  - removed the `unspecified` enum value from the `status` response property for the response status `200`
- **2025-02-05** `4ca61d8b4e33`: 1 breaking
  - the `code` response's property format changed from `int32` to no format for status `401`
- **2025-01-15** `fbf471c508c8`: 1 warning, 1 info
  - added the new `package.json` enum value to the `manifest_file/name` response property for the response status `200`
  - api operation id `getRuntimeRevision` removed and replaced with `retrieveRuntimeRevision`
- **2024-12-19** `54bca7639961`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/riza-io/apis/execute/changes/v1/runtimes/:runtime_id/revisions/:revision_id/get.md)

---

[API](https://skmtc.dev/riza-io/apis/execute.md) - [All operations](https://skmtc.dev/riza-io/apis/execute/llms.txt) - [OpenAPI document](https://skmtc.dev/riza-io/apis/execute/revisions/bab65e0b0c2b?raw)