Create Custom Curation Condition

Description: Create a new custom condition.

Since: 3.116.x

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

Usage: POST /xray/api/v1/curation/conditions

Consumes: application/json

Produces: application/json

Path Parameters: None

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

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

{
  "name": "a vuln",
  "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:16:29+02:00",
  "risk_type": "security",
  "supported_pkg_types": ["Gradle", "Maven"],
  "condition_template_id": "CVEName",
  "name": "a vuln",
  "param_values": [
    {
      "param_id": "cve_name",
      "value": "CVE-2021-45105"
    }
  ]
}

Response Codes

Status	Description
201	Created
400	Bad request