---
title: "Diff Versions"
method: GET
path: "/agent-knowledge/versions/{base_version_id}:diff/{target_version_id}"
tags: ["agent-knowledge"]
---

# Diff Versions

`GET /agent-knowledge/versions/{base_version_id}:diff/{target_version_id}`

## Request

- Base URL: `https://api.traversal.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.traversal.com/agent-knowledge/versions/{base_version_id}:diff/{target_version_id}`
- Auth: none declared

## Path parameters

- `base_version_id` string, required
- `target_version_id` string, required

## Response `200`

Successful Response

- AgentKnowledgeVersionDiffResponse
  - `fromVersion` AgentKnowledgeVersionResponse, required
    - `id` string, required
    - `commitSeq` integer, required
    - `mutationKind` string, required
    - `creator` string, required
    - `actorUserId` string, nullable
    - `sessionId` string, nullable
    - `operationMetadata` object, nullable
    - `description` string, nullable
    - `manifestS3Key` string, nullable
    - `manifestS3VersionId` string, nullable
    - `manifestSha256` string, nullable
    - `filesystemManifestSha256` string, nullable
    - `manifestEntryCount` integer, nullable
    - `manifestSizeBytes` integer, nullable
    - `cleanupEligibleAfter` string, date-time, nullable
    - `committedAt` string, date-time, required
  - `toVersion` AgentKnowledgeVersionResponse, required
    - `id` string, required
    - `commitSeq` integer, required
    - `mutationKind` string, required
    - `creator` string, required
    - `actorUserId` string, nullable
    - `sessionId` string, nullable
    - `operationMetadata` object, nullable
    - `description` string, nullable
    - `manifestS3Key` string, nullable
    - `manifestS3VersionId` string, nullable
    - `manifestSha256` string, nullable
    - `filesystemManifestSha256` string, nullable
    - `manifestEntryCount` integer, nullable
    - `manifestSizeBytes` integer, nullable
    - `cleanupEligibleAfter` string, date-time, nullable
    - `committedAt` string, date-time, required
  - `entries` AgentKnowledgeVersionDiffEntryResponse[], required
    - `objectType` string, required
    - `operation` string, required
    - `objectId` string, nullable
    - `path` string, required
    - `previousPath` string, nullable

## Other responses

- `422`: Validation Error

---

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