Skip to main content
PUT
/
bgp
/
policy
/
{policyId}
Update a BGP Policy
curl --request PUT \
  --url https://api.altostrat.io/bgp/policy/{policyId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "High-Risk Geo-IP Block",
  "enabled": true,
  "lists": [
    "9b1e3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8c"
  ],
  "sites": [
    "9a9d3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8d"
  ]
}'
{
  "id": "9b1d3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8b",
  "name": "Block Known Threats",
  "enabled": true,
  "default": false,
  "lists": [
    "9b1e3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8c"
  ],
  "site_count": 3,
  "updated_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z"
}

Authorizations

โ€‹
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

โ€‹
policyId
string<uuid>
required

The unique identifier of the BGP policy to update.

Body

application/json
โ€‹
name
string
required

A human-readable name for the policy.

Example:

"High-Risk Geo-IP Block"

โ€‹
enabled
boolean
required

Whether the policy is active.

Example:

true

โ€‹
lists
string<uuid>[]
required

A list of BGP IP reputation list IDs to include in this policy.

Example:
["9b1e3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8c"]
โ€‹
sites
string<uuid>[]

A list of site IDs to which this policy should be attached. Any sites not in this list will be detached.

Example:
["9a9d3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8d"]

Response

The BGP policy was updated successfully.

โ€‹
id
string<uuid>
Example:

"9b1d3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8b"

โ€‹
name
string
Example:

"Block Known Threats"

โ€‹
enabled
boolean
Example:

true

โ€‹
default
boolean

True if this is the default policy for the account.

Example:

false

โ€‹
lists
string<uuid>[]

A list of BGP IP reputation list IDs included in this policy.

Example:
["9b1e3e6a-5c3a-4f1e-9a0a-2b2a1e1d8e8c"]
โ€‹
site_count
integer

The number of sites currently using this policy.

Example:

3

โ€‹
updated_at
string<date-time>
โ€‹
created_at
string<date-time>