curl --request POST \
--url https://neo.api.projectdiscovery.io/api/v1/triage/bulk \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"selection": {
"excluded": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"filter": {
"archived": true,
"context": [
"<string>"
],
"include_snoozed": true,
"q": "<string>",
"severity": [],
"source_id": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"source_kind": [],
"stage": [],
"state": [
"<string>"
],
"verdict": []
},
"ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"version": "<string>"
},
"action": {
"model": "<string>",
"note": "<string>",
"until": "2023-11-07T05:31:56Z"
}
}
'import requests
url = "https://neo.api.projectdiscovery.io/api/v1/triage/bulk"
payload = {
"selection": {
"excluded": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"filter": {
"archived": True,
"context": ["<string>"],
"include_snoozed": True,
"q": "<string>",
"severity": [],
"source_id": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"source_kind": [],
"stage": [],
"state": ["<string>"],
"verdict": []
},
"ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"version": "<string>"
},
"action": {
"model": "<string>",
"note": "<string>",
"until": "2023-11-07T05:31:56Z"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
selection: {
excluded: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
filter: {
archived: true,
context: ['<string>'],
include_snoozed: true,
q: '<string>',
severity: [],
source_id: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
source_kind: [],
stage: [],
state: ['<string>'],
verdict: []
},
ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
version: '<string>'
},
action: {model: '<string>', note: '<string>', until: '2023-11-07T05:31:56Z'}
})
};
fetch('https://neo.api.projectdiscovery.io/api/v1/triage/bulk', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://neo.api.projectdiscovery.io/api/v1/triage/bulk",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'selection' => [
'excluded' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'filter' => [
'archived' => true,
'context' => [
'<string>'
],
'include_snoozed' => true,
'q' => '<string>',
'severity' => [
],
'source_id' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'source_kind' => [
],
'stage' => [
],
'state' => [
'<string>'
],
'verdict' => [
]
],
'ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'version' => '<string>'
],
'action' => [
'model' => '<string>',
'note' => '<string>',
'until' => '2023-11-07T05:31:56Z'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://neo.api.projectdiscovery.io/api/v1/triage/bulk"
payload := strings.NewReader("{\n \"selection\": {\n \"excluded\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"filter\": {\n \"archived\": true,\n \"context\": [\n \"<string>\"\n ],\n \"include_snoozed\": true,\n \"q\": \"<string>\",\n \"severity\": [],\n \"source_id\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"source_kind\": [],\n \"stage\": [],\n \"state\": [\n \"<string>\"\n ],\n \"verdict\": []\n },\n \"ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"version\": \"<string>\"\n },\n \"action\": {\n \"model\": \"<string>\",\n \"note\": \"<string>\",\n \"until\": \"2023-11-07T05:31:56Z\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://neo.api.projectdiscovery.io/api/v1/triage/bulk")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"selection\": {\n \"excluded\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"filter\": {\n \"archived\": true,\n \"context\": [\n \"<string>\"\n ],\n \"include_snoozed\": true,\n \"q\": \"<string>\",\n \"severity\": [],\n \"source_id\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"source_kind\": [],\n \"stage\": [],\n \"state\": [\n \"<string>\"\n ],\n \"verdict\": []\n },\n \"ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"version\": \"<string>\"\n },\n \"action\": {\n \"model\": \"<string>\",\n \"note\": \"<string>\",\n \"until\": \"2023-11-07T05:31:56Z\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://neo.api.projectdiscovery.io/api/v1/triage/bulk")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"selection\": {\n \"excluded\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"filter\": {\n \"archived\": true,\n \"context\": [\n \"<string>\"\n ],\n \"include_snoozed\": true,\n \"q\": \"<string>\",\n \"severity\": [],\n \"source_id\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"source_kind\": [],\n \"stage\": [],\n \"state\": [\n \"<string>\"\n ],\n \"verdict\": []\n },\n \"ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"version\": \"<string>\"\n },\n \"action\": {\n \"model\": \"<string>\",\n \"note\": \"<string>\",\n \"until\": \"2023-11-07T05:31:56Z\"\n }\n}"
response = http.request(request)
puts response.read_body{
"job": {
"can_undo": true,
"completed_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"error_code": "<string>",
"failed": 123,
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"kind": "run",
"selection": "ids",
"skipped": 123,
"status": "queued",
"total": 123,
"touched": 123,
"undone_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"undo": {
"failed": 123,
"requested_at": "2023-11-07T05:31:56Z",
"reverted": 123,
"skipped": 123
},
"version": "<string>"
}
}{
"error": "Bad request",
"code": "user_spending_cap_reached",
"error_id": "<string>",
"kind": "forbidden request",
"message": "<string>",
"param": "<string>",
"turnstile_site_key": "<string>"
}{
"error": "Bad request",
"code": "user_spending_cap_reached",
"error_id": "<string>",
"kind": "forbidden request",
"message": "<string>",
"param": "<string>",
"turnstile_site_key": "<string>"
}{
"error": "Bad request",
"code": "user_spending_cap_reached",
"error_id": "<string>",
"kind": "forbidden request",
"message": "<string>",
"param": "<string>",
"turnstile_site_key": "<string>"
}{
"error": "Bad request",
"code": "user_spending_cap_reached",
"error_id": "<string>",
"kind": "forbidden request",
"message": "<string>",
"param": "<string>",
"turnstile_site_key": "<string>"
}{
"error": "Bad request",
"code": "user_spending_cap_reached",
"error_id": "<string>",
"kind": "forbidden request",
"message": "<string>",
"param": "<string>",
"turnstile_site_key": "<string>"
}{
"error": "Bad request",
"code": "user_spending_cap_reached",
"error_id": "<string>",
"kind": "forbidden request",
"message": "<string>",
"param": "<string>",
"turnstile_site_key": "<string>"
}{
"error": "Bad request",
"code": "user_spending_cap_reached",
"error_id": "<string>",
"kind": "forbidden request",
"message": "<string>",
"param": "<string>",
"turnstile_site_key": "<string>"
}Start a bulk job on findings
Start one job that runs triage on, reviews, archives or restores many findings of your team. The selection is either up to 1,000 explicit finding ids, or a queue filter (the filters of GET /api/v1/triage/findings) with the queue version the caller saw and the ids the caller unticked (“select all N matching”). A filter selection is bound to what the caller could have seen: it is resolved on the server while the job runs, in keyset chunks of 1,000 with no limit on the number of matches, but a match first seen after the job was submitted is not part of it, and a review job leaves alone a finding whose review changed after submission (counted in skipped). The job is processed in the background in transactions of 100 findings, each finding through the same rules as its single-finding route (visibility, role, review version, run admission and the team’s run cap: a run past the cap waits queued), with the progress committed in the same transaction. Bulk jobs share the triage workers with synchronizations, so a team runs one bulk job at a time and the deployment a few (configured); a job over that waits queued. A job still live 24 hours after it was submitted fails with bulk_job_expired. A finding that cannot be changed is counted in failed (a hidden or unknown id, a review refused by the rules) or skipped (the change would change nothing, the finding changed after submission, or, for a run job, a run of the finding is in flight or this job already started one); per-finding codes are not kept. A run job starts at most one run per finding, also when its work is retried after an interruption. Poll GET /api/v1/triage/bulk/ for progress. Viewers cannot start jobs; archive and unarchive need a team admin, like the single route. Finished jobs are kept 30 days.
curl --request POST \
--url https://neo.api.projectdiscovery.io/api/v1/triage/bulk \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"selection": {
"excluded": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"filter": {
"archived": true,
"context": [
"<string>"
],
"include_snoozed": true,
"q": "<string>",
"severity": [],
"source_id": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"source_kind": [],
"stage": [],
"state": [
"<string>"
],
"verdict": []
},
"ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"version": "<string>"
},
"action": {
"model": "<string>",
"note": "<string>",
"until": "2023-11-07T05:31:56Z"
}
}
'import requests
url = "https://neo.api.projectdiscovery.io/api/v1/triage/bulk"
payload = {
"selection": {
"excluded": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"filter": {
"archived": True,
"context": ["<string>"],
"include_snoozed": True,
"q": "<string>",
"severity": [],
"source_id": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"source_kind": [],
"stage": [],
"state": ["<string>"],
"verdict": []
},
"ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"version": "<string>"
},
"action": {
"model": "<string>",
"note": "<string>",
"until": "2023-11-07T05:31:56Z"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
selection: {
excluded: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
filter: {
archived: true,
context: ['<string>'],
include_snoozed: true,
q: '<string>',
severity: [],
source_id: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
source_kind: [],
stage: [],
state: ['<string>'],
verdict: []
},
ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
version: '<string>'
},
action: {model: '<string>', note: '<string>', until: '2023-11-07T05:31:56Z'}
})
};
fetch('https://neo.api.projectdiscovery.io/api/v1/triage/bulk', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://neo.api.projectdiscovery.io/api/v1/triage/bulk",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'selection' => [
'excluded' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'filter' => [
'archived' => true,
'context' => [
'<string>'
],
'include_snoozed' => true,
'q' => '<string>',
'severity' => [
],
'source_id' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'source_kind' => [
],
'stage' => [
],
'state' => [
'<string>'
],
'verdict' => [
]
],
'ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'version' => '<string>'
],
'action' => [
'model' => '<string>',
'note' => '<string>',
'until' => '2023-11-07T05:31:56Z'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://neo.api.projectdiscovery.io/api/v1/triage/bulk"
payload := strings.NewReader("{\n \"selection\": {\n \"excluded\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"filter\": {\n \"archived\": true,\n \"context\": [\n \"<string>\"\n ],\n \"include_snoozed\": true,\n \"q\": \"<string>\",\n \"severity\": [],\n \"source_id\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"source_kind\": [],\n \"stage\": [],\n \"state\": [\n \"<string>\"\n ],\n \"verdict\": []\n },\n \"ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"version\": \"<string>\"\n },\n \"action\": {\n \"model\": \"<string>\",\n \"note\": \"<string>\",\n \"until\": \"2023-11-07T05:31:56Z\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://neo.api.projectdiscovery.io/api/v1/triage/bulk")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"selection\": {\n \"excluded\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"filter\": {\n \"archived\": true,\n \"context\": [\n \"<string>\"\n ],\n \"include_snoozed\": true,\n \"q\": \"<string>\",\n \"severity\": [],\n \"source_id\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"source_kind\": [],\n \"stage\": [],\n \"state\": [\n \"<string>\"\n ],\n \"verdict\": []\n },\n \"ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"version\": \"<string>\"\n },\n \"action\": {\n \"model\": \"<string>\",\n \"note\": \"<string>\",\n \"until\": \"2023-11-07T05:31:56Z\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://neo.api.projectdiscovery.io/api/v1/triage/bulk")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"selection\": {\n \"excluded\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"filter\": {\n \"archived\": true,\n \"context\": [\n \"<string>\"\n ],\n \"include_snoozed\": true,\n \"q\": \"<string>\",\n \"severity\": [],\n \"source_id\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"source_kind\": [],\n \"stage\": [],\n \"state\": [\n \"<string>\"\n ],\n \"verdict\": []\n },\n \"ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"version\": \"<string>\"\n },\n \"action\": {\n \"model\": \"<string>\",\n \"note\": \"<string>\",\n \"until\": \"2023-11-07T05:31:56Z\"\n }\n}"
response = http.request(request)
puts response.read_body{
"job": {
"can_undo": true,
"completed_at": "2023-11-07T05:31:56Z",
"created_at": "2023-11-07T05:31:56Z",
"error_code": "<string>",
"failed": 123,
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"kind": "run",
"selection": "ids",
"skipped": 123,
"status": "queued",
"total": 123,
"touched": 123,
"undone_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"undo": {
"failed": 123,
"requested_at": "2023-11-07T05:31:56Z",
"reverted": 123,
"skipped": 123
},
"version": "<string>"
}
}{
"error": "Bad request",
"code": "user_spending_cap_reached",
"error_id": "<string>",
"kind": "forbidden request",
"message": "<string>",
"param": "<string>",
"turnstile_site_key": "<string>"
}{
"error": "Bad request",
"code": "user_spending_cap_reached",
"error_id": "<string>",
"kind": "forbidden request",
"message": "<string>",
"param": "<string>",
"turnstile_site_key": "<string>"
}{
"error": "Bad request",
"code": "user_spending_cap_reached",
"error_id": "<string>",
"kind": "forbidden request",
"message": "<string>",
"param": "<string>",
"turnstile_site_key": "<string>"
}{
"error": "Bad request",
"code": "user_spending_cap_reached",
"error_id": "<string>",
"kind": "forbidden request",
"message": "<string>",
"param": "<string>",
"turnstile_site_key": "<string>"
}{
"error": "Bad request",
"code": "user_spending_cap_reached",
"error_id": "<string>",
"kind": "forbidden request",
"message": "<string>",
"param": "<string>",
"turnstile_site_key": "<string>"
}{
"error": "Bad request",
"code": "user_spending_cap_reached",
"error_id": "<string>",
"kind": "forbidden request",
"message": "<string>",
"param": "<string>",
"turnstile_site_key": "<string>"
}{
"error": "Bad request",
"code": "user_spending_cap_reached",
"error_id": "<string>",
"kind": "forbidden request",
"message": "<string>",
"param": "<string>",
"turnstile_site_key": "<string>"
}Body
A bulk job on findings of your team.
Response
The job, queued

