Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Equinix BGP API

Manage BGP configs and sessions. See device endpoints to create and list BGP sessions for a particular device. Check out the product docs to learn more about [Local and Global BGP](https://metal.equinix.com/developers/docs/networking/local-global-bgp/).

Equinix BGP API is one of 74 APIs that Equinix publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include BGP. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 7 operations across 5 paths, and defines 12 schemas. It is described by OpenAPI 3.0.1, at version 1.2.

Requests are made against a single base URL, https://api.equinix.com.

7 operations 5 paths 12 schemas 1 DELETE4 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
1.2
Base URL
https://api.equinix.com
Terms of Service
Resource Areas
1

Paths & Operations 7

Across 5 paths, the API surfaces 7 operations — 1 DELETE, 4 GET, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

BGP 7

Manage BGP configs and sessions. See device endpoints to create and list BGP sessions for a particular device. Check out the product docs to learn more about [Local and Global BGP…

DELETE
/bgp/sessions/{id}
Delete the BGP session
deleteBgpSession 1 param → 204401403404
GET
/bgp/sessions/{id}
Retrieve a BGP session
findBgpSessionById 2 params → 200401403404
PUT
/bgp/sessions/{id}
Update the BGP session
updateBgpSession 1 param body → 200401403404422
GET
/projects/{id}/bgp-config
Retrieve a bgp config
findBgpConfigByProject 2 params → 200401403404
POST
/projects/{id}/bgp-configs
Requesting bgp config
requestBgpConfig 2 params body → 204401403404422
GET
/projects/{id}/bgp/sessions
Retrieve all BGP sessions for project
findProjectBgpSessions 1 param → 200401404
GET
/projects/{id}/global-bgp-ranges
Retrieve all global bgp ranges
findGlobalBgpRanges 1 param → 200401403404

Schemas 12

The contract defines 12 schemas that model the data the API accepts and returns. The most detailed are BgpConfig (13 properties), BgpSession (9 properties), GlobalBgpRange (5 properties), BgpConfigRequestInput (4 properties). Each schema is shown below with its type and property counts.

BgpSession_address_family
string
BgpSession
object
9 properties 1 required
BgpSessionList
object
1 property
Error
object
Error responses are included with 4xx and 5xx HTTP responses from the API service. Either "error" or "errors" will be set.
2 properties
BgpConfigRequestInput_deployment_type
string
Wether the BGP deployment is local or global. Local deployments are configured immediately. Global deployments will need to be reviewed by Equinix Metal engine…
BgpConfig_status
string
Status of the BGP Config. Status "requested" is valid only with the "global" deploymenttype.
BgpConfig_deployment_type
string
In a Local BGP deployment, a customer uses an internal ASN to control routes within a single Equinix Metal datacenter. This means that the routes are never adv…
BgpConfig
object
13 properties
GlobalBgpRange
object
5 properties
GlobalBgpRangeList
object
1 property
BgpConfigRequestInput
object
4 properties 2 required
Href
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

equinix-bgp-api-openapi.yml Raw ↑

Other APIs Equinix publishes across the network.

Equinix Agent Templates API
Equinix Agents API
Equinix Authentication API
Equinix availability API
Equinix Batches API
Equinix Capacity API
Equinix Cloud Events API
Equinix Cloud Routers API
Equinix Company Profiles API
Equinix Connections API
Equinix Console Log Details API
Equinix Devices API