Change the settings of a Triage source

curl --request PATCH \
  --url https://neo.api.projectdiscovery.io/api/v1/triage/sources/{id}/settings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "closed_status_values": [
    "<string>"
  ],
  "context_labels": {},
  "display_name": "<string>",
  "update_policy": {}
}
'

import requests

url = "https://neo.api.projectdiscovery.io/api/v1/triage/sources/{id}/settings"

payload = {
    "closed_status_values": ["<string>"],
    "context_labels": {},
    "display_name": "<string>",
    "update_policy": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    closed_status_values: ['<string>'],
    context_labels: {},
    display_name: '<string>',
    update_policy: {}
  })
};

fetch('https://neo.api.projectdiscovery.io/api/v1/triage/sources/{id}/settings', 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/sources/{id}/settings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'closed_status_values' => [
        '<string>'
    ],
    'context_labels' => [
        
    ],
    'display_name' => '<string>',
    'update_policy' => [
        
    ]
  ]),
  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/sources/{id}/settings"

	payload := strings.NewReader("{\n  \"closed_status_values\": [\n    \"<string>\"\n  ],\n  \"context_labels\": {},\n  \"display_name\": \"<string>\",\n  \"update_policy\": {}\n}")

	req, _ := http.NewRequest("PATCH", 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.patch("https://neo.api.projectdiscovery.io/api/v1/triage/sources/{id}/settings")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"closed_status_values\": [\n    \"<string>\"\n  ],\n  \"context_labels\": {},\n  \"display_name\": \"<string>\",\n  \"update_policy\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://neo.api.projectdiscovery.io/api/v1/triage/sources/{id}/settings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"closed_status_values\": [\n    \"<string>\"\n  ],\n  \"context_labels\": {},\n  \"display_name\": \"<string>\",\n  \"update_policy\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "auto_triage": {
    "consecutive_failures": 123,
    "contexts": [
      "<string>"
    ],
    "enabled": true,
    "interval_minutes": 15,
    "model": "<string>",
    "last_error_code": "<string>",
    "last_run_at": "2023-11-07T05:31:56Z",
    "last_run_count": 123,
    "next_run_at": "2023-11-07T05:31:56Z",
    "user_email": "<string>"
  },
  "closed_status_values": [
    "<string>"
  ],
  "context_labels": {},
  "display_name": "<string>",
  "source_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "update_policy": {},
  "updated_at": "2023-11-07T05:31:56Z"
}

{
  "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>"
}

Triage

Change the settings of a Triage source

Change the supplied settings of one source of your team. Team admins only. Inbox listings and synchronization never write these settings, so a display name survives them. The update policy is stored and never executed. Saving an enabled auto triage rule makes you its actor: the rule runs as you, so your membership, admin role, visibility of the source, the model and your credit eligibility are checked now and again before every run. Disabling the rule cancels its queued jobs. Built-in sources accept settings whatever TRIAGE_CUSTOM_SOURCES_MODE says; enabling auto triage on a custom source needs custom sources on.

PATCH

api

triage

sources

{id}

settings

Change the settings of a Triage source

curl --request PATCH \
  --url https://neo.api.projectdiscovery.io/api/v1/triage/sources/{id}/settings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "closed_status_values": [
    "<string>"
  ],
  "context_labels": {},
  "display_name": "<string>",
  "update_policy": {}
}
'

import requests

url = "https://neo.api.projectdiscovery.io/api/v1/triage/sources/{id}/settings"

payload = {
    "closed_status_values": ["<string>"],
    "context_labels": {},
    "display_name": "<string>",
    "update_policy": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    closed_status_values: ['<string>'],
    context_labels: {},
    display_name: '<string>',
    update_policy: {}
  })
};

fetch('https://neo.api.projectdiscovery.io/api/v1/triage/sources/{id}/settings', 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/sources/{id}/settings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'closed_status_values' => [
        '<string>'
    ],
    'context_labels' => [
        
    ],
    'display_name' => '<string>',
    'update_policy' => [
        
    ]
  ]),
  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/sources/{id}/settings"

	payload := strings.NewReader("{\n  \"closed_status_values\": [\n    \"<string>\"\n  ],\n  \"context_labels\": {},\n  \"display_name\": \"<string>\",\n  \"update_policy\": {}\n}")

	req, _ := http.NewRequest("PATCH", 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.patch("https://neo.api.projectdiscovery.io/api/v1/triage/sources/{id}/settings")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"closed_status_values\": [\n    \"<string>\"\n  ],\n  \"context_labels\": {},\n  \"display_name\": \"<string>\",\n  \"update_policy\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://neo.api.projectdiscovery.io/api/v1/triage/sources/{id}/settings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"closed_status_values\": [\n    \"<string>\"\n  ],\n  \"context_labels\": {},\n  \"display_name\": \"<string>\",\n  \"update_policy\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "auto_triage": {
    "consecutive_failures": 123,
    "contexts": [
      "<string>"
    ],
    "enabled": true,
    "interval_minutes": 15,
    "model": "<string>",
    "last_error_code": "<string>",
    "last_run_at": "2023-11-07T05:31:56Z",
    "last_run_count": 123,
    "next_run_at": "2023-11-07T05:31:56Z",
    "user_email": "<string>"
  },
  "closed_status_values": [
    "<string>"
  ],
  "context_labels": {},
  "display_name": "<string>",
  "source_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "update_policy": {},
  "updated_at": "2023-11-07T05:31:56Z"
}

{
  "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>"
}

Authorizations

Authorization

string

header

required

JWT authentication token

Path Parameters

string<uuid>

required

Source id

Body

application/json

Settings to change; omitted fields keep their value.

auto_triage

object

The auto triage rule to save. Saving it enabled makes you the admin it runs as.

Show child attributes

closed_status_values

string[]

Source status values that count as closed at the source (custom API sources). Replaces the stored values.

Maximum array length: 50

Required string length: 1 - 100

context_labels

object

Display labels per context. Replaces the stored labels.

Show child attributes

display_name

string

Name to show for the source. Inbox listings and synchronization never change it.

Required string length: 1 - 80

update_policy

object

How the source would be updated after a review. Stored only; never executed.

Response

The source settings after the change

The settings of a source: its display name, labels per context, update policy (stored, never executed), closed status values (custom sources) and auto triage rule.

auto_triage

object

required

The auto triage rule of a source. It runs as its actor, the admin who last saved it enabled. A rule pauses (enabled false, last_error_code set) when its actor leaves the team (membership_revoked), is no longer an admin (actor_not_admin), can no longer see the source (source_not_visible), or after repeated failed runs. Turning TRIAGE_REVIEWS_MODE off (or custom sources off, for a custom source) does not pause it: its runs end with triage_reviews_disabled (or custom_sources_disabled) and the rule resumes when the switch is on again.

Show child attributes

closed_status_values

string[]

required

Source status values that count as closed at the source (custom API sources).

context_labels

object

required

Display labels per context, for example a name for a HackerOne program handle.

Show child attributes

display_name

string

required

The name set in the settings, or the source name when none is set.

source_id

string<uuid>

required

The source these settings belong to.

update_policy

object

required

How the source would be updated after a review. Stored only; Neo never writes to the source.

updated_at

string<date-time>

When the settings last changed.