List all policies

get

https://{jfrog_url}/unifiedpolicy/api/v1/policies

Retrieve a paginated list of all policies in the system. This endpoint supports pagination and filtering of policies based on various criteria.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

enabled

boolean

Filter by policy enabled status.

mode

string

enum

Filter by policy mode.

Allowed:

action_type

string

enum

Filter policies by action types.

Allowed:

scope_type

string

enum

length ≤ 50

Filter policies by scope type (project or application).

Allowed:

stage_key

array of objects

Filter policies by stage. Multiple values can be provided for filtering.

stage_key

stage_gate

array of objects

Filter policies by gate. Multiple values can be provided for filtering.

stage_gate

rule_id

array of objects

Filter policies by rule ID. Multiple values can be provided for filtering.

rule_id

project_key

string

length between 1 and 255

Filter policies by project key.

hierarchical

boolean

Adding hierarchy filter logic in combination with other scope filter.

application_label_key

array of objects

Filter policies by application label key. Multiple values can be provided for filtering.

application_label_key

application_label_value

array of objects

Filter policies by application label value. Multiple values can be provided for filtering.

application_label_value

application_labels

object

Filter policies by application labels with exact key/value matches using deepObject style. Provide each label as a key in the object with its value as the property value.

Examples (preferred):

application_labels[environment]=production
application_labels[tier]=backend&application_labels[maturity]=beta

Notes:

When this filter is present, the scope type is enforced as project.
Policies without labels are included only when no label filters are specified.

application_key

array of objects

Filter policies by application key. Multiple values can be provided for filtering.

application_key

array of strings

Query by the resource id. Multiple values can be provided for filtering.

name

array of objects

Query by the resource name. Multiple values can be provided for filtering.

name

offset

int32

≥ 0

Defaults to 0

A page offset to the requested page.

limit

int32

1 to 1000

Defaults to 100

An integer value representing the maximum number of items to include in the response.

sort_by

string

enum

Defaults to created_at

Policy attribute to sort by.

Allowed:

sort_order

string

enum

Defaults to desc

Sort direction.

Allowed:

expand

string

enum

Expand policy response to include complete rule objects.

Allowed:

Responses

200The request has succeeded.

400The request syntax was invalid or malformed, or validation failed.

401Authentication credentials are required or invalid.

403You do not have sufficient permissions to perform this action.

500An unexpected error occurred. Please contact support.