Skip to main content
Compare Versions
Any pair — not only draft against live. Each difference names the field as this API names it, so you can act on it directly:
Compares configuration only. Labels, timestamps and version numbers are not differences in how the agent behaves, and neither are the agent’s tools — those are a dashboard surface, so a difference never names a field you cannot read or write here.

Authorizations

Authorization
string
header
required

Your API key as a Bearer token, e.g. Authorization: Bearer vk_….

Path Parameters

agent_id
string
required

The agent's id, as GET /v1/agents returns it.

Query Parameters

left
string
required

version number, e.g. 3

right
string
required

version number, e.g. 4

Response

What differs between the two versions, named in this API's own fields.

left
PublicVersionSummary · object
required

The first version of the pair.

right
PublicVersionSummary · object
required

The second version of the pair.

differences
VersionDiff · object[]

Every configuration field that differs, in PUBLIC field paths — the same paths you send on a PATCH. Metadata (labels, timestamps, version numbers) is excluded: it always differs and says nothing about behaviour.