Get an agent version
Returns one past version’s configuration and findings, for comparing versions. Secrets in tool settings are never returned.
Scopes: agent:read
Authorizations
An API key from Settings → API keys, sent as Authorization: Bearer kb_live_…. A workspace key starts kb_; a personal key starts kbp_ and acts as its owner.
Headers
The API version to answer as, a date (YYYY-MM-DD). Leave it out for the current version (2026-11-07). An unknown version is refused with 400 unsupported_api_version.
2026-11-07 "2026-11-07"
Response
Successful Response
The version's id.
The version number, counting from 1.
The version's state.
draft, published, superseded, invalid The configuration saved in this version. Secrets are redacted.
A fingerprint of config.
The configuration schema version.
When it was saved (ISO 8601).
The note saved with it.
When it went live, if it did (ISO 8601).
Validation findings: {severity, code, path, message, provider}.