Enterprise Management API Reference

Complete specifications for public telemetry discovery and regional edge worker coordination endpoints.

Authentication & Rate Limits

The PulseGate API architecture is divided into two distinct security tiers:

Public Telemetry: Unauthenticated GET requests served by apex origin. Rate limited to 1,000 requests per minute per IP.
Edge Worker Coordination: Requires a cryptographic Bearer token passed in the Authorization HTTP header. Rate limited to 120 requests per minute per token.

1. Public Telemetry & PoP Discovery (Apex Endpoints)

Unauthenticated public JSON endpoints served directly by pulsegate.cloud.

`GET https://pulsegate.cloud/api/v1/health` (or `/health.json`)

Returns global cluster health and operational status.

curl -fsSL https://pulsegate.cloud/api/v1/health

Response (200 OK):

{
  "service": "pulsegate-apex",
  "status": "operational",
  "cluster": "regional-edge"
}

`GET https://pulsegate.cloud/api/v1/nodes` (or `/pops.json`)

Returns active regional Edge PoP cluster directory.

curl -fsSL https://pulsegate.cloud/api/v1/nodes

Response (200 OK):

[
  {
    "id": "RU-SPB-01",
    "name": "Saint Petersburg Edge PoP",
    "subdomain": "runner-ru",
    "fqdn": "runner-ru.pulsegate.cloud",
    "city": "Saint Petersburg",
    "country": "Russian Federation",
    "datacenter": "Carrier-Neutral Tier-III Facility",
    "status": "operational",
    "latency_ms": 4
  },
  {
    "id": "FI-HEL-01",
    "name": "Helsinki Edge PoP",
    "subdomain": "runner-fi",
    "fqdn": "runner-fi.pulsegate.cloud",
    "city": "Helsinki",
    "country": "Finland",
    "datacenter": "Carrier-Neutral Tier-III Facility",
    "status": "operational",
    "latency_ms": 19
  }
]

2. Edge Node Control & Worker Coordination

Distributed regional management endpoints deployed on each Edge PoP node.

`POST https://api.gw-<region>.pulsegate.cloud/v1/session/create`

Allocates an interactive virtual desktop display streaming session on the specified regional cluster.

curl -X POST https://api.gw-<region>.pulsegate.cloud/v1/session/create \
  -H "Authorization: Bearer <TENANT_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"workspace_id": "ws-alpha-9", "resolution": "1920x1080", "framerate": 60}'

Standard Error Response Format

Unauthenticated or unauthorized requests return HTTP 401 Unauthorized:

{
  "error": "unauthorized",
  "message": "Valid Bearer token required",
  "code": 401
}