Skip to main content
PATCH
Change which version is the current (active) version for a policy. This is useful for rolling back to a previous version or promoting a specific version.
Agents that reference this policy will automatically use the new current version on their next job run.

Path Parameters

Query Parameters

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

policy_id
string<uuid>
required
version_id
string<uuid>
required

Query Parameters

organization_id
string<uuid>

Organization ID. This is required for access control. It can be provided via query or request body depending on the endpoint.

Body

application/json

Policy serializer

name
string
Required string length: 1 - 255
description
string

Response

200 - application/json

Policy serializer

id
string<uuid>
required
read-only
name
string
required
Maximum string length: 255
organization_id
string<uuid>
required
read-only
current_version_id
string<uuid> | null
required
read-only
created_at
string<date-time>
required
read-only
updated_at
string<date-time>
required
read-only
description
string