Skip to content
API Enriched

List of mitigations.

POST
/api/infraprotect/namespaces/{namespace}/infraprotect/mitigations
curl --request POST \
  --url https://example-corp.console.ves.volterra.io/api/v1/api/production/us-east-1/namespaces/default/api/infraprotect/namespaces/example/infraprotect/mitigations \
  --header 'Authorization: <Authorization>' \
  --header 'Content-Type: application/json' \
  --data '{ "end_time": "2026-04-15T12:00:00Z", "event_id": "example", "namespace": "example", "network_id": "example", "start_time": "2026-04-15T12:00:00Z" }'

Returns a list of mitigations.

Examples of this operation.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
namespace
required
string

Namespace This request is supported only in system namespace.

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
Mitigations request

Request to GET a list of mitigations.

object
end_time
End time

End time of metric collection from which data will be considered to build graph. Format: RFC3339 string

Optional: If not specified, then the end_time will be evaluated to

string format: date-time
<= 1024 characters
event_id
Event

Filter mitigations by an event

Optional: If not specified, then all tenant’s events are considerate.

string
<= 1024 characters
namespace
Namespace

This request is supported only in system namespace.

string
>= 6 characters <= 1024 characters
network_id
Network

Filter mitigations by network

Optional: If not specified, then all tenant’s networks are considerate.

string
<= 1024 characters
start_time
Start time

Start time of metric collection from which data will be considered to build graph. Format: RFC3339 string

Optional: If not specified, then the start_time will be evaluated to -3d.

string format: date-time
<= 1024 characters
Examplegenerated
{
  "end_time": "2026-04-15T12:00:00Z",
  "event_id": "example",
  "namespace": "example",
  "network_id": "example",
  "start_time": "2026-04-15T12:00:00Z"
}

Responses

Section titled “Responses”

200

Section titled “200”

A successful response.

Media typeapplication/json
Mitigations response

Response giving a list of mitigations.

object
mitigations
Mitigations

Filtered mitigations.

Array<object>
Mitigation

Mitigation details.

object
arbor_id
L3/L4 ID

L3/L4 provider identity string.

string
<= 1024 characters
creator
Creator

Creator of the alert (or SOC if created manually)

string
<= 1024 characters
end_time
End time

RFC3339 string of the mitigation end time.

string format: date-time
<= 1024 characters
id
ID

Mitigation ID.

string
>= 1 <= 4094 <= 1024 characters
is_ongoing
Ongoing

True if the mitigation is still ongoing.

boolean format: boolean
name
Name

Mitigation name.

string
>= 6 characters <= 1024 characters
network_id
NetworkID

ID of the network involved in the mitigation.

string
<= 1024 characters
network_name
Network

Name of the network involved in the mitigation.

string
<= 1024 characters
offramp
Offramp

Offramp related to the mitigation.

string
<= 1024 characters
start_time
Start time

RFC3339 string of the mitigation start time.

string format: date-time
<= 1024 characters
Examplegenerated
{
  "mitigations": [
    {
      "arbor_id": "example",
      "creator": "example",
      "end_time": "2026-04-15T12:00:00Z",
      "id": "example",
      "is_ongoing": true,
      "name": "example",
      "network_id": "example",
      "network_name": "example",
      "offramp": "example",
      "start_time": "2026-04-15T12:00:00Z"
    }
  ]
}

401

Section titled “401”

Returned when operation is not authorized.

Media typeapplication/json
string format: string
Examplegenerated
example

403

Section titled “403”

Returned when there is no permission to access resource.

Media typeapplication/json
string format: string
Examplegenerated
example

404

Section titled “404”

Returned when resource is not found.

Media typeapplication/json
string format: string
Examplegenerated
example

409

Section titled “409”

Returned when operation on resource is conflicting with current value.

Media typeapplication/json
string format: string
Examplegenerated
example

429

Section titled “429”

Returned when operation has been rejected as it is happening too frequently.

Media typeapplication/json
string format: string
Examplegenerated
example

500

Section titled “500”

Returned when server encountered an error in processing API.

Media typeapplication/json
string format: string
Examplegenerated
example

503

Section titled “503”

Returned when service is unavailable temporarily.

Media typeapplication/json
string format: string
Examplegenerated
example

504

Section titled “504”

Returned when server timed out processing request.

Media typeapplication/json
string format: string
Examplegenerated
example