Archive a draft, rejected, or safe old policy version.

POST

/v1/policies/{policy_version}/archive

Authorizations

• oidc

Parameters

Path Parameters

policy_version

required

string

>= 1 characters

Query Parameters

tenant_id

string

>= 1 characters

environment_id

string

>= 1 characters

Request Body ^required

object

manifest_hash

string

/^sha256:[a-f0-9]{64}$/

etag

string

>= 1 characters

reason_code

required

string

/^[a-z0-9_]+$/

reason

string

<= 500 characters

actor_id

Rejected if supplied; actor is derived from authentication context.

string

Responses

202

Policy archived.

object

schema_version

required

policy_version

required

string

>= 1 characters

status

required

string

Allowed values: draft validating published archived rejected

manifest_hash

required

string

/^sha256:[a-f0-9]{64}$/

etag

required

string

>= 1 characters

audit_event_id

required

string | null

validation

required

object

valid

required

boolean

status

required

Allowed values: not_validated valid invalid

checked_at

required

string | null format: date-time

checked_by

required

string | null

rule_count

required

integer

errors

required

Array<object>

object

reason_code

required

string

/^[a-z0-9_]+$/

message

required

string

>= 1 characters

line

required

integer | null

>= 1

column

required

integer | null

>= 1

path

required

string

>= 1 characters

403

Missing policy.archive.

409

Active or in-use policy cannot be archived.