---
title: "Compare Registry Versions"
method: GET
path: "/registry/repos/{repository_id}/versions/{version_id}/diff"
tags: ["registry-repositories"]
---

# Compare Registry Versions

`GET /registry/repos/{repository_id}/versions/{version_id}/diff`

## Request

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

Compare two registry versions and return the diff.

Args:
    repository_id: The repository ID
    version_id: The base version ID (typically older)
    compare_to: The version ID to compare against (typically newer)

Returns:
    VersionDiff with added, removed, and modified actions

## Path parameters

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

## Query parameters

- `compare_to` string, uuid, required

## Response `200`

Successful Response

- VersionDiff: Result of comparing two registry versions.
  - `base_version_id` string, uuid, required
  - `base_version` string, required
  - `compare_version_id` string, uuid, required
  - `compare_version` string, required
  - `actions_added` string[]
  - `actions_removed` string[]
  - `actions_modified` ActionChange[]
    - `action_name` string, required
    - `change_type` 'added' | 'removed' | 'modified', required
    - `interface_changes` ActionInterfaceChange[]
      - `field` 'expects' | 'returns', required
      - `change_type` 'added' | 'removed' | 'modified', required
      - `old_value` object, nullable
      - `new_value` object, nullable
    - `description_changed` boolean
  - `total_changes` integer

## 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)