Skip to main content
GET
Get an agent version

Authorizations

Authorization
string
header
required

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

Kallabot-Version
enum<string>

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.

Available options:
2026-11-07
Example:

"2026-11-07"

Path Parameters

agent_id
string
required
version_id
string
required

Response

Successful Response

id
string
required

The version's id.

version
integer
required

The version number, counting from 1.

status
enum<string>
required

The version's state.

Available options:
draft,
published,
superseded,
invalid
config
Config · object
required

The configuration saved in this version. Secrets are redacted.

config_hash
string
required

A fingerprint of config.

schema_version
integer
required

The configuration schema version.

created_at
string
required

When it was saved (ISO 8601).

change_note
string | null

The note saved with it.

published_at
string | null

When it went live, if it did (ISO 8601).

findings
Findings · object[]

Validation findings: {severity, code, path, message, provider}.