Rescan stored content against the current signature database now, instead of waiting for the sweep. Quarantines on a detection.
Input
application/jsoncid
string
Required
The content address to rescan.
Output
application/jsonfindingId
integer
Optional
The ID of the recorded finding, for a detection.
quarantined
boolean
Optional
Whether the content was quarantined. False for clean and unscanned verdicts, and for a PUA match when BARD_SCAN_ON_UNWANTED=log.
signature
string
Optional
The signature name, for a detection.
verdict
string
Required
The scanner's verdict. `unscanned` means the scanner declined to look at the bytes; it is neither a pass nor a failure.
clean, malware, unwanted, unscannedErrors
BlobNotFound
Nothing is stored under that CID. ScannerUnavailable
The scanner did not respond. Safe to retry. Try It
Requests are sent directly from your browser. Some servers may block requests due to CORS.
View raw schema
{
"type": "procedure",
"input": {
"schema": {
"type": "object",
"required": [
"cid"
],
"properties": {
"cid": {
"type": "string",
"description": "The content address to rescan."
}
}
},
"encoding": "application/json"
},
"errors": [
{
"name": "BlobNotFound",
"description": "Nothing is stored under that CID."
},
{
"name": "ScannerUnavailable",
"description": "The scanner did not respond. Safe to retry."
}
],
"output": {
"schema": {
"type": "object",
"required": [
"verdict"
],
"properties": {
"verdict": {
"type": "string",
"description": "The scanner's verdict. `unscanned` means the scanner declined to look at the bytes; it is neither a pass nor a failure.",
"knownValues": [
"clean",
"malware",
"unwanted",
"unscanned"
]
},
"findingId": {
"type": "integer",
"description": "The ID of the recorded finding, for a detection."
},
"signature": {
"type": "string",
"description": "The signature name, for a detection."
},
"quarantined": {
"type": "boolean",
"description": "Whether the content was quarantined. False for clean and unscanned verdicts, and for a PUA match when BARD_SCAN_ON_UNWANTED=log."
}
}
},
"encoding": "application/json"
},
"description": "Rescan stored content against the current signature database now, instead of waiting for the sweep. Quarantines on a detection."
}