Get a KB entry version

GET

/api/kb-entries/versions/{versionId}

• Production

Returns a single knowledge base entry version, including its captured content and audit metadata. Version rows are immutable and survive deletion of the parent entry.

Authorizations

• bearerAuth

Parameters

Path Parameters

versionId

required

string format: uuid

The unique identifier of the version to retrieve.

Responses

200

The version was found and returned.

A single published, superseded, or rejected version of a knowledge base entry. Restoring a version creates a new published version rather than mutating history.

object

id

required

Unique identifier for this version row.

string format: uuid

Example

v1a2b3c4-5678-9abc-def0-1234567890ab

tenantId

required

The tenant this version belongs to.

string format: uuid

Example

a0b1c2d3-4567-89ab-cdef-0123456789ab

workspaceId

required

The workspace the parent entry is scoped to.

string format: uuid

Example

w1a2b3c4-5678-9abc-def0-1234567890ab

entryId

required

The entry this version belongs to.

string format: uuid

Example

kb1a2b3c-5678-9abc-def0-1234567890ab

versionNumber

required

Monotonic version number within the entry, starting at 1.

integer

Example

3

status

required

Lifecycle status of this version. ‘published’ is the currently active version, ‘superseded’ is a former published version, ‘draft’ and ‘pending_review’ are unpublished work, ‘rejected’ was declined in review.

string

Allowed values: draft pending_review published superseded rejected

Example

published

sessionId

The change-set session that produced this version, when one applies.

string | null format: uuid

question

required

The question or topic captured in this version.

string

Example

What are your delivery times to Germany?

answer

required

The answer captured in this version.

string

Example

Standard delivery to Germany takes 3-5 business days.

topics

required

Topic tags captured in this version.

Array<string>

Example

[
  "shipping",
  "delivery",
  "germany"
]

authorUserId

Identifier of the actor who authored this version, or an api-key actor reference when created programmatically.

string | null

Example

kp_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d

authorNote

Optional note the author attached to this version.

string | null

Example

Corrected the delivery estimate for Germany.

sourceType

required

How this version was produced. Values include ‘manual’, ‘extracted’, ‘learning_loop’, ‘backfill’, ‘restore’, and ‘sandbox_apply’.

string

Example

manual

sourceSessionId

The originating session when this version was produced by an applied change-set.

string | null format: uuid

sourceConversationId

The conversation that inspired this version, when it originated from a resolved conversation.

string | null format: uuid

predecessorVersionId

The version this one succeeds. Null for the first version.

string | null format: uuid

publishedAt

Timestamp when this version became published. Null while unpublished.

string | null format: date-time

Example

2026-03-15T10:30:00.000Z

supersededAt

Timestamp when this version was superseded by a newer one. Null while current.

string | null format: date-time

rejectedAt

Timestamp when this version was rejected in review, when applicable.

string | null format: date-time

rejectionReason

Reason recorded when the version was rejected in review.

string | null

createdAt

required

Timestamp when this version row was created.

string format: date-time

Example

2026-03-15T10:30:00.000Z

updatedAt

required

Timestamp when this version row was last updated.

string format: date-time

Example

2026-03-15T10:30:00.000Z

404

No KB entry version exists with the given ID in the authenticated tenant.

Standard error response returned by all endpoints on failure.

object

error

required

A human-readable error message describing what went wrong.

string

Example

Conversation not found