Search
K
Cipherscale API

List All Network Addresses

Retrieves all network addresses configured for the tenant, including IP addresses, hostnames, and domain names with their associated protocols and access types.

get
https://public-api.cipherscale.com/qa/tenants/addresses

Response

application/json

Successfully retrieved addresses

idstring(uuid)required
addressstringrequired
isIpbooleanrequired
typestringrequired

Allowed values:PRIVATESAASINTERNET

protocolsarray[object]required
Show Child Parameters
get/tenants/addresses
 
application/json

Get Address Details

Retrieves detailed information about a specific network address including its type, associated protocols, and linked gateways.

get
https://public-api.cipherscale.com/qa/tenants/addresses/{id}

Path Parameters

idstringrequired

The unique identifier of the address

Response

application/json

Successfully retrieved the address

AddressDto

idstring(uuid)required
addressstringrequired
isIpbooleanrequired
typestringrequired

Allowed values:PRIVATESAASINTERNET

protocolsarray[object]required
Show Child Parameters
get/tenants/addresses/{id}
 
application/json

Update Network Address

Modifies the configuration of an existing network address including its associated protocols and access settings.

put
https://public-api.cipherscale.com/qa/tenants/addresses/{id}

Path Parameters

idstringrequired

The unique identifier of the address to update

Body

application/json

The address data to update

UpdateAddressDto

protocolsarray[string](uuid)required
addressstringrequired

Response

application/json

Successfully updated the address

AddressDto

idstring(uuid)required
addressstringrequired
isIpbooleanrequired
typestringrequired

Allowed values:PRIVATESAASINTERNET

protocolsarray[object]required
Show Child Parameters
put/tenants/addresses/{id}

Body

{ "protocols": [ "[]" ], "address": "address" }
 
application/json

Remove Network Address

Permanently removes a network address from the tenant. This operation will also remove the address from any associated resources.

delete
https://public-api.cipherscale.com/qa/tenants/addresses/{id}

Path Parameters

idstringrequired

The unique identifier of the address to delete

Response

Successfully deleted the address

delete/tenants/addresses/{id}
 

Get Gateways for Address

Retrieves all gateways that provide access to the specified network address, showing the network topology and access paths for the address.

get
https://public-api.cipherscale.com/qa/tenants/addresses/{id}/gateways

Path Parameters

idstringrequired

The unique identifier of the address

Response

application/json

Successfully retrieved linked gateways

Network gateway configuration and status information

idstring(uuid)required

Unique identifier for the gateway

createdAtstring(date-time)required

Timestamp when the gateway was created

deployedOnstring | null(date-time)required

Timestamp when the gateway was first successfully deployed

updatedAtstring(date-time)required

Timestamp when the gateway was last updated

namestringrequired

Human-readable name for the gateway

descriptionstring

Detailed description of the gateway’s purpose and location

wireguardPortstringrequired

WireGuard VPN port number for this gateway

statusstringrequired

Current operational status of the gateway

Allowed values:PENDINGONLINEOFFLINEMAINTENANCEERROR

errorstring

Error message if the gateway is in ERROR status

tokenstringrequired

Authentication token for gateway communication

lastOnlinestring(date-time)

Timestamp when the gateway was last online

relayEnabledboolean

Whether the gateway can relay traffic between network segments

endpointstring

Network endpoint address for the gateway

autoDiscoverEndpointbooleanrequired

Whether the gateway endpoint is automatically discovered

resourcesarray[object]

List of resources accessible through this gateway

Show Child Parameters
get/tenants/addresses/{id}/gateways
 
application/json