Skip to content
adversarial

List all proposals to change threats made for the organization

GET
/v1/threats/proposals
curl --request GET \
  --url 'https://api.adversarial.com/api/v1/threats/proposals?page=1&page_size=5'

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
page
integer format: int64
default: 1 >= 1 <= 1000000

1-indexed page number. Defaults to 1; zero is rejected.

page_size
integer format: int64
default: 5 >= 1 <= 100

Rows per page. Defaults to 5, max 100; zero is rejected.

Responses

Section titled “Responses”

200

Section titled “200”

List all proposals

Media typeapplication/json

Paginated list envelope: { "results": [...], "pagination": {...} }.

object
pagination
required

Pagination metadata describing the slice.

object
page
required

1-indexed page number of this result slice.

integer format: int64
page_size
required

Number of items requested per page.

integer format: int64
total_items
required

Total number of matching items across all pages.

integer format: int64
total_pages
required

Total number of pages at this page size.

integer format: int64
results
required

The items on this page.

Array<object>

A threat profile change proposal together with every action it contains.

object
actions
required
Array<object>

A single proposed threat change, with the inherent scores it would set.

object
action
required
object
comment
string | null
created_by
One of:
null
created_date
required
string format: date-time
deleted_date
string | null format: date-time
id
required
integer format: int64
updated_date
string | null format: date-time
scores
required
Array<object>

The current inherent scoring of a threat objective.

An inherent score is always scoped to one organization and one threat objective; it has no meaning outside that pairing.

object
created_date
required

The date the score was created.

string format: date-time
id
required

An auto-incrementing PK value that uniquely identifies the score given the threat objective name

integer format: int64
impact
required

The y-axis

string
Allowed values: Very Low Low Medium High Severe
is_draft
required

Whether this inherent score is a draft (excluded from some threat-level responses).

boolean
likelihood
required

The x-axis

string
Allowed values: Remote Unlikely Possible Probable Imminent
proposal_action_id
required

The proposal action PK that this score is associated with

integer format: int64
proposal_id
required

The proposal PK that this score is associated with

integer format: int64
threat_objective_name
required

The threat objective PK

string
Allowed values: Sabotage Data Disclosure Extortion Customer Targeting Resource Hijacking Fraud
proposal
required
object
approved_by
One of:
null
approved_date
string | null format: date-time
created_by
One of:
null
created_date
required
string format: date-time
denied_by
One of:
null
denied_date
string | null format: date-time
id
required
integer format: int64
Example
{
  "results": [
    {
      "actions": [
        {
          "scores": [
            {
              "impact": "Very Low",
              "likelihood": "Remote",
              "threat_objective_name": "Sabotage"
            }
          ]
        }
      ]
    }
  ]
}