myOneTrustDeveloper ForumTechnology Partners
API Reference
Subscribe via RSS
Start typing to search…

Create or Update Risk

put
https://{hostname}/api/risk/v2/risks/upsert

Use this API to create a new risk or update an existing one based on matching attributes. If a risk with matching attributes exists, it will be updated; otherwise, a new risk will be created.

Query Params
string
required

List of attributes to match for upsert operation

Body Params
string
required

risk type

source
object
required

source information

associatedInventory
object
required

associated inventory information

string
length between 0 and 4000

description

string
length between 0 and 4000

recommendation

int64

condition Group Id for risk creation rule.

uuid

condition Group uuid for risk creation rule.

uuid
deprecated

risk owner id

string
deprecated

risk owner name

riskOwners
array of objects

list of risk owners

riskOwners
uuid
required

organization group id

riskApproversId
array of uuids

list of approver ids

riskApproversId
date-time

deadline, format - YYYY-MM-DDTHH:MM:SS.FFFZ

int64

number of days before the deadline when the reminder will be sent

int64

probability level id

string

probability level name

int64

impact level id

string

impact level name

number

risk score

int64

risk level Id

boolean

system created flag

categoryIds
array of uuids

risk categories' Ids

categoryIds
controlIds
array of uuids

risk controls' Ids

controlIds
uuid

risk threat' Id

vulnerabilityIds
array of uuids

risk vulnerability' Ids

vulnerabilityIds
attributeValues
object

Custom Attributes

uuid

ruleRootVersion id

riskTemplate
object

risk template

targetRiskLevel
object

target risk level

string
length between 0 and 300

name for the risk

string
length between 0 and 4000

AKA remediation in current workflow

riskManager
array of uuids

list of manager ids

riskManager
Responses

400

Bad Request

401

Unauthorized

403

Forbidden

500

Internal Server Error

Updated 4 months ago

Language
Credentials
OAuth2
Missing 2 required scopes
URL
Response 
 Choose an example:
application/json
*/*
Updated 4 months ago