Try JFrog
API Reference
Contact SupportTry JFrog

Update Policy

put
https://jf.example.com/xray/api/v2/policies/

Updates an existing policy (v2 API). The policy name in the URL path is authoritative — it overrides any name field in the request body. The full policy definition must be provided (full replacement, not partial update).

Requires the "Manage Policies" role to be set on the User or Group level.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The name of the policy to update. This value takes precedence over any name in the request body.

Query Params
string

When provided, the update is scoped to the specified project.

Body Params

Request body for creating or updating a policy. A policy defines rules that determine how Xray identifies and acts on issues found during scanning. Each policy has a type (security, license, or operational_risk) and contains one or more rules. Each rule has criteria (what to match) and actions (what to do when matched).

string
required

Name of the policy. Must be unique across the system (or within a project when using projectKey).

string

Optional free-text description of the policy.

string
enum
required

The policy type. Determines which criteria fields are available in the rules.

Allowed:
rules
array of objects
required

One or more rules that define the policy behavior. Each rule specifies criteria to match and actions to take when matched.

rules*
Responses

Updated about 1 month ago

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 1 month ago