Skip to main content
POST
Set the pending version aside

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 all authenticated routes — validated before authentication (middleware/tenant.ts), so a missing or non-UUID header returns 400 (MISSING_TENANT_ID / INVALID_TENANT_ID) before the API key is checked.

Path Parameters

id
string<uuid>
required
version
integer
required
Required range: x >= 1

Body

application/json
reason
string
required

Required: why the pending version is set aside (e.g. a hot fix to the version in force must go first). Must contain a non-whitespace character. Recorded on the version (closed_reason) and in the audit trail.

Required string length: 1 - 2000
Pattern: .*\S.*

Response

Default Response

id
string<uuid>
required
policy_id
string<uuid>
required
version
integer
required
draft_revision
integer
required
Required range: x >= 0
rules
object[]
required
is_active
boolean
required
status
required

Lifecycle status: draft → submitted → ratified → (activated, then) superseded (or back to draft on reject); discarded = soft-discarded draft (PWB-039). A pending version that ends without governing is closed: reopened (a ratified version whose content continues as a new draft), set_aside (put aside with a reason), replaced (a draft whose correction continues as a new draft) — PAL-004/005.

Available options:
draft
created_at
string<date-time>
required
created_by
string | null
required
change_reason
string | null
required
ratified_by
string
ratified_at
string<date-time>
submitted_by
string
submitted_at
string<date-time>
rejected_by
string
rejected_at
string<date-time>
rejection_reason
string
closed_at
string<date-time>
closed_by
string
closed_reason
string
codification_record
object

What the codification that produced this version accounted for. Unsigned and unhashed; NOT a sealed review package.