Security Performance Management
Continuous Monitoring
Cyber Insurance
National Cybersecurity

Articles in this section

PATCH: Edit an Underwriting Guideline

Avatar
Ingrid
Follow
Publication Date – April 28, 2023

⇤ Underwriting Guidelines

https://api.bitsighttech.com/ratings/v1/underwriting-guidelines/guideline_guid

Edit an existing underwriting guideline.

Only Admin can edit underwriting guidelines. See underwriting guideline user permissions.

Parameters

*Required.

Parameter Description Values 
guid
Path		 Identify the underwriting guideline to edit. [String] Underwriting guideline unique identifier [guideline_guid]. See GET: Underwriting Guidelines. 
risk_vectors
Body		 Define the guidelines for each risk vector. [Array] 
"risk_vectors": [
  {
    […]
  }
  
risk_vector_slug
Body		 Identify the risk vector to edit. [String] The risk vector slug. See risk types. 
minimum_grade
Body		 Set the minimum risk vector grade. [String] A - F 
is_active
Body		 Determine if the minimum risk vector grade should be active for comparison. [Boolean]
  • true = Risk vector and its minimum grade are active for comparison.
  • false = Risk vector and its minimum grade are not active for comparison.

Example Request

curl 'https://api.bitsighttech.com/ratings/v1/underwriting-guidelines/m521bb61-33c4-42c9-1234-c8194c305db3' -u api_token -X PATCH -H 'Accept: application/json' -H 'Content-Type: application/json' --data-binary '{
  "risk_vectors": [
    {
      "risk_vector_slug": "application_security",
      "minimum_grade": "A",
      "is_active": "true"
    }
  ]
}' --compressed

Status Codes

Code Description
200 – Okay Everything worked as expected.
400 – Bad Request This can often be due to missing a required parameter.
401 – No Authentication No valid API token was provided.
403 – Unauthorized You do not have permission to access this resource.
404 – Not Found The specified resource could not be found.

Related articles