idstring(uuid)required
The unique identifier (UUID) of the gateway to delete
Remove Gateway
Permanently removes a gateway from the tenant. This operation will disconnect all associated resources and may impact network connectivity. Ensure all resources are reassigned to other gateways before deletion.
delete
https://public-api.cipherscale.com/qa/tenants/gateways/{id}
Path Parameters
Response
Response
Successfully deleted the gateway
delete/tenants/gateways/{id}
Authentication
Path Parameters
curl --request DELETE \
--url https://public-api.cipherscale.com/qa/tenants/gateways/ \
--header 'Content-Type: application/json' \
--header 'apikey: 'Successfully deleted the gatewayUpdate Gateway Configuration
Updates gateway settings including name, description, WireGuard port, endpoint configuration, and operational status. Changes may require gateway restart to take effect.
patch
https://public-api.cipherscale.com/qa/tenants/gateways/{id}
Path Parameters
idstring(uuid)required
The unique identifier (UUID) of the gateway to update
Body
application/json
Body
application/json
UpdateGateway
Data for updating gateway configuration
statusstring
Current operational status of the gateway
Allowed values:PENDINGONLINEOFFLINEMAINTENANCEERROR
Example:ONLINE
namestringrequired
Human-readable name for the gateway
Example:US-East Gateway
descriptionstring
Detailed description of the gateway’s purpose and location
Example:Primary gateway for US East region data center
wireguardPortstringrequired
WireGuard VPN port number for this gateway
Example:51820
endpointstring
Network endpoint address for the gateway
Example:gateway-us-east.company.com
Response
200 application/json
Response
200 application/json
Successfully updated gateway configuration
Gateway
Network gateway configuration and status information
idstring(uuid)required
Unique identifier for the gateway
createdAtstring(date-time)required
Timestamp when the gateway was created
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]
Resource information accessible through a gateway
Example:{"id":"550e8400-e29b-41d4-a716-446655440000","name":"Internal Web Server"}
Show Child Parameters
patch/tenants/gateways/{id}
Authentication
Path Parameters
Body
{
"name": "US-East Gateway",
"description": "Primary gateway for US East region data center",
"wireguardPort": "51820",
"endpoint": "gateway-us-east.company.com",
"status": "ONLINE"
}{
"name": "US-East Gateway",
"description": "Primary gateway for US East region data center",
"wireguardPort": "51820",
"endpoint": "gateway-us-east.company.com",
"status": "ONLINE"
}
curl --request PATCH \
--url https://public-api.cipherscale.com/qa/tenants/gateways/ \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'apikey: ' \
--data '{
"name": "US-East Gateway",
"description": "Primary gateway for US East region data center",
"wireguardPort": "51820",
"endpoint": "gateway-us-east.company.com",
"status": "ONLINE"
}' 200 application/json
{
"id": "id",
"createdAt": "createdAt",
"updatedAt": "updatedAt",
"name": "name",
"description": "description",
"wireguardPort": "wireguardPort",
"status": "PENDING",
"error": "error",
"token": "token",
"lastOnline": "lastOnline",
"relayEnabled": false,
"endpoint": "endpoint",
"autoDiscoverEndpoint": false,
"resources": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Internal Web Server"
}
]
}Get Gateway Details
Retrieves comprehensive information about a specific gateway including its configuration, current status, associated resources, and connection statistics.
get
https://public-api.cipherscale.com/qa/tenants/gateways/{id}
Path Parameters
idstring(uuid)required
The unique identifier (UUID) of the gateway
Example:123e4567-e89b-12d3-a456-426614174000
Response
application/json
Response
application/json
Successfully retrieved the gateway
Gateway
Network gateway configuration and status information
idstring(uuid)required
Unique identifier for the gateway
createdAtstring(date-time)required
Timestamp when the gateway was created
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]
Resource information accessible through a gateway
Example:{"id":"550e8400-e29b-41d4-a716-446655440000","name":"Internal Web Server"}
Show Child Parameters
get/tenants/gateways/{id}
Authentication
Path Parameters
curl --request GET \
--url https://public-api.cipherscale.com/qa/tenants/gateways/123e4567-e89b-12d3-a456-426614174000 \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'apikey: ' application/json
{
"id": "id",
"createdAt": "createdAt",
"updatedAt": "updatedAt",
"name": "name",
"description": "description",
"wireguardPort": "wireguardPort",
"status": "PENDING",
"error": "error",
"token": "token",
"lastOnline": "lastOnline",
"relayEnabled": false,
"endpoint": "endpoint",
"autoDiscoverEndpoint": false,
"resources": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Internal Web Server"
}
]
}Enable Gateway Relay
Enables relay functionality for the gateway, allowing it to forward traffic between different network segments and improve connectivity for remote users.
post
https://public-api.cipherscale.com/qa/tenants/gateways/{id}/enable-relay
Path Parameters
idstring(uuid)required
The unique identifier (UUID) of the gateway
Response
application/json
Response
application/json
Successfully enabled gateway relay
Gateway
Network gateway configuration and status information
idstring(uuid)required
Unique identifier for the gateway
createdAtstring(date-time)required
Timestamp when the gateway was created
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]
Resource information accessible through a gateway
Example:{"id":"550e8400-e29b-41d4-a716-446655440000","name":"Internal Web Server"}
Show Child Parameters
post/tenants/gateways/{id}/enable-relay
Authentication
Path Parameters
curl --request POST \
--url https://public-api.cipherscale.com/qa/tenants/gateways//enable-relay \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'apikey: ' application/json
{
"id": "id",
"createdAt": "createdAt",
"updatedAt": "updatedAt",
"name": "name",
"description": "description",
"wireguardPort": "wireguardPort",
"status": "PENDING",
"error": "error",
"token": "token",
"lastOnline": "lastOnline",
"relayEnabled": false,
"endpoint": "endpoint",
"autoDiscoverEndpoint": false,
"resources": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Internal Web Server"
}
]
}Disable Gateway Relay
Disables relay functionality for the gateway, restricting it to direct connections only. This may improve security but reduce connectivity options.
post
https://public-api.cipherscale.com/qa/tenants/gateways/{id}/disable-relay
Path Parameters
idstring(uuid)required
The unique identifier (UUID) of the gateway
Response
application/json
Response
application/json
Successfully disabled gateway relay
Gateway
Network gateway configuration and status information
idstring(uuid)required
Unique identifier for the gateway
createdAtstring(date-time)required
Timestamp when the gateway was created
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]
Resource information accessible through a gateway
Example:{"id":"550e8400-e29b-41d4-a716-446655440000","name":"Internal Web Server"}
Show Child Parameters
post/tenants/gateways/{id}/disable-relay
Authentication
Path Parameters
curl --request POST \
--url https://public-api.cipherscale.com/qa/tenants/gateways//disable-relay \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'apikey: ' application/json
{
"id": "id",
"createdAt": "createdAt",
"updatedAt": "updatedAt",
"name": "name",
"description": "description",
"wireguardPort": "wireguardPort",
"status": "PENDING",
"error": "error",
"token": "token",
"lastOnline": "lastOnline",
"relayEnabled": false,
"endpoint": "endpoint",
"autoDiscoverEndpoint": false,
"resources": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Internal Web Server"
}
]
}