---
title: "Diff a tree against the previous tree"
method: GET
path: "/context-documents/tree/{tree_id}/diff"
tags: ["Context Documents"]
---

# Diff a tree against the previous tree

`GET /context-documents/tree/{tree_id}/diff`

Compute a diff between the given tree and the most recent completed tree
before it. Used by the knowledge manager to review what changed between
generations.

## Path parameters

- `tree_id` string, required

## Response `200`

Successful Response

- DiffResponse
  - `tree_id` string, required
  - `previous_tree_id` string, nullable, required
  - `files_added` integer, required
  - `files_removed` integer, required
  - `files_changed` integer, required
  - `files_unchanged` integer, required
  - `diffs` FileDiff[], required
    - `path` string, required
    - `status` string, required
    - `old_content` string, nullable
    - `new_content` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/hyperspell/apis/hyperspell-api.md) · [All operations](https://skmtc.net/hyperspell/apis/hyperspell-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hyperspell/hyperspell-api/versions/5721acd588e6/schema)