Restore a policy entry version

POST

/api/policy-entries/{entryId}/versions/{versionId}/restore

• Production

Restores a previous version of a policy entry by publishing its content as a new version. History is preserved: the prior published version is superseded rather than overwritten. When the restored content already matches the current content, no new version is created.

Authorizations

• bearerAuth

Parameters

Path Parameters

entryId

required

string format: uuid

The unique identifier of the policy entry.

versionId

required

string format: uuid

The unique identifier of the version to restore.

Responses

200

The version was restored and a new published version was recorded, or the restore was a no-op.

The result of restoring a version. A restore creates a new published version rather than mutating history. When the restored content matches the current content, no new version is created.

object

versionId

required

Identifier of the newly published version, or of the existing current version when the restore was a no-op.

string format: uuid

Example

v9a8b7c6-5432-10fe-dcba-0987654321ab

created

required

Whether a new version was created. False when the restored content already matched the current content.

boolean

Example

true

restoredFrom

required

The version number that was restored.

integer

Example

2

404

No policy entry or 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