DivisionCero

Create a risk

POST
/risks

Requires risks.write.

Authorization

apiKey
headerAuthorizationBearer <token>

Request Body

application/json
  1. body
title*string
Length1 <= length <= 200
description?|null
category_id*string

A risk category of the team (GET /risks/catalogs)

Formatuuid
approach_id*string

A risk approach of the team (GET /risks/catalogs)

Formatuuid
threat?|null
vulnerability?|null
consequence?|null
owner_user_id?|

A member of the team

inherent_likelihood*integer
Range1 <= value <= 5
inherent_impact*integer
Range1 <= value <= 5
residual_likelihood?integer

Defaults to the inherent one

Range1 <= value <= 5
residual_impact?integer

Defaults to the inherent one

Range1 <= value <= 5
treatment?string
Value in"modify""retain""avoid""share"
treatment_plan?|null
status?string
Value in"identified""analyzed""evaluated""inTreatment""monitored""closed"
review_date?|null

Response Body

OK

application/json
  1. response
id*string
Formatuuid
code*string
title*string
description*string|null
category_id*string
Formatuuid
approach_id*string
Formatuuid
threat*string|null
vulnerability*string|null
consequence*string|null
cia*array<string>
owner_user_id*|null
inherent_likelihood*integer
Range-9007199254740991 <= value <= 9007199254740991
inherent_impact*integer
Range-9007199254740991 <= value <= 9007199254740991
residual_likelihood*integer
Range-9007199254740991 <= value <= 9007199254740991
residual_impact*integer
Range-9007199254740991 <= value <= 9007199254740991
treatment*string
Value in"modify""retain""avoid""share"
treatment_plan*string|null
status*string
Value in"identified""analyzed""evaluated""inTreatment""monitored""closed"
review_date*|null
created_at*string

ISO 8601 timestamp

updated_at*string

ISO 8601 timestamp

Example Request
curl -X POST 'https://app.divisioncero.com/api/v1/risks' \  -H 'Content-Type: application/json' \  -d '{  "title": "string",  "category_id": "8de4c9fd-61a4-4c0b-bf88-0ed3a0fe3fa2",  "approach_id": "21e548fe-632f-42f0-a399-edb08ccb4da2",  "inherent_likelihood": 1,  "inherent_impact": 1}'
Example Response201
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "code": "string",  "title": "string",  "description": "string",  "category_id": "8de4c9fd-61a4-4c0b-bf88-0ed3a0fe3fa2",  "approach_id": "21e548fe-632f-42f0-a399-edb08ccb4da2",  "threat": "string",  "vulnerability": "string",  "consequence": "string",  "cia": [    "string"  ],  "owner_user_id": "65139110-7c3c-4777-b692-80c218be3b9d",  "inherent_likelihood": -9007199254740991,  "inherent_impact": -9007199254740991,  "residual_likelihood": -9007199254740991,  "residual_impact": -9007199254740991,  "treatment": "modify",  "treatment_plan": "string",  "status": "identified",  "review_date": "string",  "created_at": "string",  "updated_at": "string"}

¿Qué te pareció esta guía?