---
title: "Promote Registry Version"
method: POST
path: "/registry/repos/{repository_id}/versions/{version_id}/promote"
tags: ["registry-repositories"]
---

# Promote Registry Version

`POST /registry/repos/{repository_id}/versions/{version_id}/promote`

## Request

- Base URL: `https://platform.tracecat.com/api`
- URL: `https://platform.tracecat.com/api/registry/repos/{repository_id}/versions/{version_id}/promote`
- Auth: API key in cookie `fastapiusersauth`

Promote a specific version to be the current version of an org-scoped repository.

This endpoint allows administrators to manually promote or rollback to a
specific registry version, overriding the auto-promotion that happens during sync.

For platform registries, use the admin API at
/admin/registry/{repository_id}/versions/{version_id}/promote.

Args:
    repository_id: The ID of the repository
    version_id: The ID of the version to promote

Returns:
    RegistryVersionPromoteResponse with previous and current version info

Raises:
    404: If repository or version not found
    400: If version doesn't belong to repository or has no tarball

## Path parameters

- `repository_id` string, uuid, required
- `version_id` string, uuid, required

## Response `200`

Successful Response

- TracecatRegistryRepositoriesSchemasRegistryVersionPromoteResponse: Response model for version promotion.
  - `repository_id` string, uuid, required
  - `origin` string, required
  - `previous_version_id` string, uuid, nullable, required
  - `current_version_id` string, uuid, required
  - `version` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tracecat/apis/tracecat-api.md) - [All operations](https://skmtc.dev/tracecat/apis/tracecat-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tracecat/apis/tracecat-api/revisions/2efdda25045f?raw)