Skip to main content

VPN Sessions

Connect​

POST /cvault/v1/vpn/connect

Headers: X-API-Key, Authorization: Bearer <jwt>

{"deviceId": "uuid"}
License Required

This endpoint requires licenseCheck middleware. The user must have a valid, non-expired license with remaining uses. Returns 402 Payment Required if no valid license exists.

Response:

{
  "sessionId": "uuid",
  "status": "connected",
  "connectedAt": "2026-03-29T10:00:00Z",
  "message": "VPN connection established"
}

Disconnect​

POST /cvault/v1/vpn/disconnect
{"deviceId": "uuid"}

Status​

GET /cvault/v1/vpn/status

Returns all active sessions for the authenticated user:

{
  "activeSessions": [
    {
      "sessionId": "uuid",
      "connectedAt": "2026-03-29T10:00:00Z",
      "device": {
        "id": "uuid",
        "deviceName": "My MacBook",
        "assignedIp": "10.8.0.5"
      },
      "server": {
        "publicIp": "98.92.255.171",
        "region": "us-east-1"
      }
    }
  ],
  "totalActive": 1
}