Skip to content

Read a policy version including editable safe body, validation, usage, hash, and permissions.

GET
/v1/policies/{policy_version}
policy_version
required
string
>= 1 characters
tenant_id
string
>= 1 characters
environment_id
string
>= 1 characters

Policy detail.

object
schema_version
required
policy_version
required
string
>= 1 characters
status
required
string
Allowed values: draft validating published archived rejected
tenant_id
required
string
>= 1 characters
environment_id
required
string
>= 1 characters
owner
required
object
user_id
required
string
>= 1 characters
team
required
string
>= 1 characters
source
required
object
source_type
required
string
>= 1 characters
source_ref
string | null
description
required
string | null
body_format
required
body
required

Safe editable gateway policy manifest. Never contains prompts, payloads, tokens, or credential material.

object
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
version_state
required
object
active_in_environment
required
boolean
previous_policy_version
required
string | null
last_published_at
required
string | null format: date-time
last_published_by
required
string | null
archived_at
required
string | null format: date-time
archived_by
required
string | null
usage_refs
required
Array<object>
object
server_id
required
string
>= 1 characters
tool_id
required
string | null
snapshot_id
required
string | null
status
required
string
>= 1 characters
manifest_hash
required
string
/^sha256:[a-f0-9]{64}$/
etag
required
string
>= 1 characters
permissions
required
object
resource_type
required
resource_id
required
string
>= 1 characters
allowed_actions
required
Array
Allowed values: policy.read policy.write policy.validate policy.publish policy.archive

Missing policy.read.

Policy not found in scoped environment.

Type set in Geist, Source Serif 4, and Departure Mono.