Skip to main content
GET
List policy versions

Authorizations

Authorization
string
header
required

Bearer token issued by Softmax

Query Parameters

limit
integer
default:100

Maximum policy versions returned.

Required range: 1 <= x <= 500
cursor
string | null

Continuation token from the previous response's X-Next-Cursor header.

q
string | null

Return policies whose names contain this text.

mine
boolean
default:false

Return only policy versions owned by the caller.

player_id
string | null

Return only policy versions attributed to this player.

Pattern: ^ply_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Response

Successful Response

policy_version_id
string<uuid>
required

Policy version ID.

policy_id
string<uuid>
required

Policy containing this version.

policy_name
string
required

Human-readable policy name.

version
integer
required

Sequential version number within the policy.

created_at
string<date-time>
required

Time when this policy version was created.

player_id
string | null

Player associated with this version, or null when none is assigned.

player_name
string | null

Name of the associated player, or null when none is assigned.