UtilitiesWAN

clearSiteBgpRoutes

POST
/api/v1/sites/{site_id}/devices/{device_id}/clear_bgp

Clear routes associated with one or all BGP neighbors

Authorization

Authorization<token>

Preferred authentication method for automation and integrations. Send the API token in the HTTP Authorization header.

Format: Authorization: Token {apitoken}

Notes:

  • An API token generated for a specific admin has the same privileges as that admin
  • An API token is automatically removed if it is not used for more than 90 days
  • SSO admins cannot generate admin API tokens. Use organization API tokens when scoped Org/Site privileges are needed.

In: header

Path Parameters

site_id*string
Formatuuid
device_id*string
Formatuuid

Request Body

application/json

Request to clear BGP sessions on a device

neighbor*string

can be ip, ipv6, all

Default"all"
node?ha_cluster_node_enum

HA cluster node on which to clear BGP sessions. enum: node0, node1.

Value in

  • "node0"
  • "node1"
type*utils_clear_bgp_type

BGP clear operation type to run. enum: hard, in, out, soft.

Default"hard"

Value in

  • "hard"
  • "in"
  • "out"
  • "soft"
vrf?string

Routing instance or VRF containing the BGP session

Response Body

curl -X POST "https://example.com/api/v1/sites/000000ab-00ab-00ab-00ab-0000000000ab/devices/000000ab-00ab-00ab-00ab-0000000000ab/clear_bgp" \  -H "Content-Type: application/json" \  -d '{    "neighbor": "all",    "type": "in",    "vrf": "TestVrf"  }'
{  "session": "19e73828-937f-05e6-f709-e29efdb0a82b"}