Update Custom Curation Condition

Description: Update an existing custom condition

Since: 3.116.x

Security: Requires a valid user with the "MANAGE_POLICIES" permission.

Usage: PUT /xray/api/v1/curation/conditions/{condition_id}

Consumes: application/json

Produces: application/json

Path Parameters: condition_id

Query Parameters: None

Request Body

Name	Type	Description
`condition_template_id`	string	One of the IDs of the supported condition templates returned by the list condition templates api
`name`	string	The name of the condition
`param_values`	Array[ParamWithValue]	Array of parameter values.

ParamWithValue

Name	Type	Description
`param_id`	string	A `param_id` that is allowed with the `condition_template_id` of the condition
`value`	Various. See explanation in the section about List Curation Condition Templates API.	A value that is allowed for the `param_id`

Response Body

Name	Type	Description
`id`	string	The ID of the condition, used as path parameter when updating or deleting the condition and when referring to it in a policy.
`condition_template_id`	string	One of the IDs of the supported condition templates returned by the list condition templates api
`name`	string	The name of the condition
`is_custom`	Boolean	false for built-in immutable conditions, true for mutable user created custom conditions
`created_at`	string	Timestamp when the condition was created
`updated_at`		Timestamp when the condition was updated
`risk_type`		One of: `security`, `legal` or `operational`.
`supported_pkg_types`		One of: "`npm`", "`PyPI`", "`Maven`", "Go", "`NuGet`", "`Conan`", "`Gems`", "`Gradle`", "`HuggingFaceML`" or "`Docker`". Additional package types will be added.
`param_values`	Array[ParamWithValue]	Array of parameter values.

Sample Request

PUT /xray/api/v1/curation/conditions/29
Authorization: …
Content-Type: application/json

{
  "name": "log4shell",
  "condition_template_id": "CVEName",
  "param_values": [{"param_id": "cve_name", "value": "CVE-2021-45105"}]
}

Sample Response

{
  "id": "29",
  "is_custom": true,
  "created_by": "admin",
  "created_at": "2025-03-12T13:16:29+02:00",
  "updated_by": "admin",
  "updated_at": "2025-03-12T13:19:01+02:00",
  "risk_type": "security",
  "supported_pkg_types": ["Gradle", "Maven"],
  "condition_template_id": "CVEName",
  "name": "log4shell",
  "param_values": [
    {
      "param_id": "cve_name",
      "value": "CVE-2021-45105"
    }
  ]
}

Response Codes:

Status	Description
200	OK
400	Bad request
404	Not found