Skip to content

Peers

All operations require authentication.

5 operationsv1/overTheBox/{serviceName}
Agent setup

List the WireGuard peers of an OverTheBox serviceBeta

GET
/1.0/overTheBox/{serviceName}/wireguard/peers

Returns the IDs of the WireGuard peers configured on the OverTheBox service.

Path parameters

serviceName
required
string

Service name

Response

200string[]successful operation

Example uses serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/overTheBox/{serviceName}/wireguard/peers \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
[ "string"]

Create a WireGuard peer on an OverTheBox serviceBeta

POST
/1.0/overTheBox/{serviceName}/wireguard/peers

Adds a WireGuard peer to the service from its name, description, public key and private IPv4. Returns the created peer.

Path parameters

serviceName
required
string

Service name

Request body (required)

description
required
string

Wireguard peer description

name
required
string

Wireguard peer name

privateIpv4
required
ipv4Block

Wireguard peer private IP

publicKey
required
string

Wireguard peer public key

Response

200peersuccessful operation
active
read-only
boolean

Wireguard peer status

description
read-only
string

Wireguard peer description

name
read-only
string

Wireguard peer name

peerId
read-only
string

Wireguard peer id

privateIpv4
read-only
ipv4Block

Wireguard peer private IP

publicKey
read-only
string

Wireguard peer public key

Example uses serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/overTheBox/{serviceName}/wireguard/peers \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "active": true, "description": "string", "name": "string", "peerId": "string", "privateIpv4": "192.0.2.0/24", "publicKey": "string"}

Get a WireGuard peer of an OverTheBox serviceBeta

GET
/1.0/overTheBox/{serviceName}/wireguard/peers/{peerId}

Returns a WireGuard peer with its name, description, public key, private IPv4 and whether it is active.

Path parameters

peerId
required
string

Peer ID

serviceName
required
string

Service name

Response

200peersuccessful operation
active
read-only
boolean

Wireguard peer status

description
read-only
string

Wireguard peer description

name
read-only
string

Wireguard peer name

peerId
read-only
string

Wireguard peer id

privateIpv4
read-only
ipv4Block

Wireguard peer private IP

publicKey
read-only
string

Wireguard peer public key

Example uses peerId = string, serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/overTheBox/{serviceName}/wireguard/peers/{peerId} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "active": true, "description": "string", "name": "string", "peerId": "string", "privateIpv4": "192.0.2.0/24", "publicKey": "string"}

Update a WireGuard peer of an OverTheBox serviceBeta

PUT
/1.0/overTheBox/{serviceName}/wireguard/peers/{peerId}

Changes the name, description, public key, private IPv4 or active status of a WireGuard peer. Returns the task that applies the change.

Path parameters

peerId
required
string

Peer ID

serviceName
required
string

Service name

Request body (required)

active
boolean

Wireguard peer status

description
string

Wireguard peer description

name
string

Wireguard peer name

privateIpv4
ipv4Block

Wireguard peer private IP

publicKey
string

Wireguard peer public key

Response

200tasksuccessful operation
name
read-only
string

Service task name

status
read-only
statusEnum

Service task status

Valuesdoingdoneerrortodo
taskId
read-only
string

Service task ID

Example uses peerId = string, serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/overTheBox/{serviceName}/wireguard/peers/{peerId} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "name": "string", "status": "doing", "taskId": "string"}

Delete a WireGuard peer of an OverTheBox serviceBeta

DELETE
/1.0/overTheBox/{serviceName}/wireguard/peers/{peerId}

Removes the WireGuard peer from the service. Returns the task that performs the removal.

Path parameters

peerId
required
string

Peer ID

serviceName
required
string

Service name

Response

200tasksuccessful operation
name
read-only
string

Service task name

status
read-only
statusEnum

Service task status

Valuesdoingdoneerrortodo
taskId
read-only
string

Service task ID

Example uses peerId = string, serviceName = string

$ curl https://api.eu.ovhcloud.com/1.0/overTheBox/{serviceName}/wireguard/peers/{peerId} \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "name": "string", "status": "doing", "taskId": "string"}