Compare two agent versions

GET

/api/agents/{agentId}/versions/{v1}/diff/{v2}

Computes the differences between two versions of an agent, returning both full snapshots plus a field-level diff and a human-readable change summary.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Path Params

Responses

🟢200

application/json

Comparison result between the two versions.

Bodyapplication/json

🟠401

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.snakk.ai/api/agents//versions//diff/' \
--header 'X-API-Key: <api-key>'

Response Example

200 - Example 1

{
    "version1": {
        "version_number": 0,
        "created_at": "2019-08-24T14:15:22.123Z",
        "change_summary": "string",
        "config": {
            "property1": "string",
            "property2": "string"
        },
        "tools": [
            {
                "property1": "string",
                "property2": "string"
            }
        ]
    },
    "version2": {
        "version_number": 0,
        "created_at": "2019-08-24T14:15:22.123Z",
        "change_summary": "string",
        "config": {
            "property1": "string",
            "property2": "string"
        },
        "tools": [
            {
                "property1": "string",
                "property2": "string"
            }
        ]
    },
    "diff": {
        "config": {
            "property1": {
                "old": null,
                "new": null,
                "changed": true
            },
            "property2": {
                "old": null,
                "new": null,
                "changed": true
            }
        },
        "tools": {
            "property1": {
                "old": null,
                "new": null,
                "changed": true
            },
            "property2": {
                "old": null,
                "new": null,
                "changed": true
            }
        },
        "summary": [
            "Greeting message changed",
            "Voice changed"
        ]
    }
}

Modified at 2026-07-08 19:01:40

Get a specific agent version

Restore an agent to a version