Search
K
Cipherscale API

Reactivate Device

Restores network access for a previously deactivated device. This operation allows the device to reconnect to the network with its previous configuration and permissions.

post
https://public-api.cipherscale.com/qa/tenants/devices/{id}/reactivate

Path Parameters

idstring(uuid)required

The unique identifier (UUID) of the device to reactivate

Response

Successfully reactivated the device

post/tenants/devices/{id}/reactivate
 

Gateways

Network gateway configuration and management

Create New Gateway

Creates a new network gateway that will serve as an access point for users and devices to connect to the tenant’s network resources. The gateway will be configured with WireGuard VPN settings and endpoint information.

post
https://public-api.cipherscale.com/qa/tenants/gateways

Body

application/json

The gateway data to create

CreateGateway

Data required to create a new network gateway

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

application/json

Successfully created 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
post/tenants/gateways

Body

{ "name": "US-East Gateway", "description": "Primary gateway for US East region data center", "wireguardPort": "51820", "endpoint": "gateway-us-east.company.com" }
 
application/json

List All Gateways

Retrieves a comprehensive list of all gateways configured for the tenant, including their status, configuration details, and associated resources. This information is essential for network topology management.

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

Response

application/json

Successfully retrieved 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

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
 
application/json

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

idstring(uuid)required

The unique identifier (UUID) of the gateway to delete

Response

Successfully deleted the gateway

delete/tenants/gateways/{id}