Skip to main content
GET
Get policy

Authorizations

Authorization
string
header
required

MeshQu API key passed as a bearer token: Authorization: Bearer mqu_…. Mint one in the console (Settings → API keys).

X-MeshQu-Tenant-Id
string
header
required

Tenant UUID for multi-tenant isolation. Required on authenticated routes. A missing or non-UUID value returns 400 MISSING_TENANT_ID or INVALID_TENANT_ID before API-key authentication.

Path Parameters

id
string<uuid>
required

Query Parameters

version
string

Version to return. Defaults to latest: a draft if one exists, otherwise the active ratified version, otherwise the highest version number. active selects the active ratified version; draft selects the first draft; a number selects that exact version. Returns 404 if the selected version does not exist.

Pattern: ^(active|draft|latest|[1-9][0-9]*)$

Response

Default Response

id
string<uuid>
required
tenant_id
string<uuid>
required
code
string
required
name
string
required
description
string | null
required
decision_type
string
required
current_version
integer
required
is_active
boolean
required
shadow_mode
boolean
required

When true, violations are logged but DENY becomes ALERT

policy_group_id
string<uuid> | null
required

Policy group this policy belongs to

created_at
string<date-time>
required
created_by
string | null
required
updated_at
string<date-time>
required
regulatory_refs
string[] | null

Regulatory references this policy implements

regulatory_refs_warnings
object[]

Warnings for regulatory_refs entries not found in the clause registry. Informational only — the save proceeded.

version
object
versionState

Lifecycle state of the selected version. discarded never governed a decision and cannot be restored. reopened, set_aside and replaced are pending versions closed without governing; they remain available for comparison.

Available options:
active
selectedVersion
integer
permissions
object

Convenience permission flags. Clients MUST use actions[] as the source of truth for availability; permissions are for disable-state/tooltip hints only.

actions
object[]