Create Remediation Request
POST/uve/api/v1/remediation/vuln-create-remediation
You create one of the following remediation action request for an asset or a set of assets:
Create a task or JIRA ticket
Create a merge request
Suppress the vulnerability
Remediation action request can be created at the following levels:
Asset level- Perform remediation action on an asset by asset ID
Group level- Perform remediation action for all the assets of a particular asset type for a specified CVE ID
Global level- Perform remediation action on all assets of a specified CVE ID.
Note: You need 'vulnerabilityRemediation' feature with 'Create' permission to access this endpoint. Verify if your permission group includes this feature using the Get Permission Group by ID endpoint. You can also check this in the Prisma Cloud console by ensuring that Alerts > Remediate Vulnerabilities is enabled.
Request
Header Parameters
JIRA ID. Required only for createTask remediation action.
JIRA assignee. Required only for createTask remediation action.
- application/json
Body
- Array [
- ]
CVE ID of the vulnerability.
Prisma ID of the customer.
Possible values: [createTask
, createPr
, suppress
]
Remediation action: create a JIRA/task, create a PR, or suppress the vulnerability.
Possible values: [iac
, package
, deployedImage
, serverlessFunction
, host
, registryImage
, vmImage
]
Asset type. Required only for group level remediation.
assetId object[]
Asset IDs. Required only for asset level remediation.
Possible values: [iac
, package
, deployedImage
, serverlessFunction
, host
, registryImage
, vmImage
]
Type of asset.
UAI ID of the asset.
Responses
- 200
- 206
- 400
ACCEPTED
- application/json
- Schema
- Example (from schema)
Schema
Response message
Error details if applicable
Timestamp of resppnse
UUID identifier to indentify the request
{
"message": "ACCEPTED",
"details": "",
"timeStamp": 1701778720128,
"request_id": "b17d66dd-2f8c-46f0-be1a-b3e21ba7990c"
}
PARTIALLY ACCEPTED
- application/json
- Schema
- Example (from schema)
Schema
Response message
Error details if applicable
Timestamp of resppnse
UUID identifier to indentify the request
{
"message": "PARTIALLY_ACCEPTED",
"details": "Assets are suppressed or Jira Ticket already exists",
"timeStamp": 1701778720128,
"request_id": "b17d66dd-2f8c-46f0-be1a-b3e21ba7990c"
}
BAD REQUEST
- application/json
- Schema
- Example (from schema)
Schema
Response message
Error details if applicable
Timestamp of resppnse
UUID identifier to indentify the request
{
"message": "BAD_REQUEST",
"details": "Invalid payload",
"timeStamp": 1701778720128,
"request_id": "b17d66dd-2f8c-46f0-be1a-b3e21ba7990c"
}