---
title: "Create runtime revision"
method: POST
path: "/v1/runtimes/{id}/revisions"
tags: ["Runtime"]
---

# Create runtime revision

`POST /v1/runtimes/{id}/revisions`

Creates a new runtime revision.

## Path parameters

- `id` string, required

## Request body

- CreateRuntimeRevisionRequest
  - `additional_python_imports` string
  - `manifest_file` ManifestFile, required
    - `contents` string, required
    - `name` 'requirements.txt' | 'package.json', 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`
  - added the new `package.json` enum value to the request property `manifest_file/name`
- **2024-12-19** `54bca7639961` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/riza-io/apis/execute/changes/v1/runtimes/:id/revisions/post.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-service-production.skmtc.workers.dev/v1/apis/riza-io/execute/revisions/bab65e0b0c2b/schema)