Skip to main content
GET
List policy versions

Authorizations

Authorization
string
header
required

Bearer token issued by Softmax

Query Parameters

name_exact
string | null

Return versions of policies with this exact name.

name_fuzzy
string | null

Return versions of policies whose names contain this text.

version
integer | null

Return only this version number.

policy_version_ids
string[] | null

Return only these policy versions.

policy_id
string<uuid> | null

Return versions of this policy.

player_id
string | null

Return 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}$
include_unbound_player
boolean
default:false

When filtering by player, also include versions not attributed to any player.

mine
boolean
default:false

Return only versions owned by the caller.

limit
integer
default:50

Maximum versions returned.

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

Opaque cursor returned by the previous page.

Response

Successful Response

entries
PolicyVersionRow · object[]
required

Policy versions in this page, newest first.

next_cursor
string | null
required

Opaque cursor for the next page, or null when this is the last page.