Enterprise Management API Reference

REST API specifications for global discovery and regional Edge PoP cluster management.

Public Telemetry & PoP Discovery

Served directly by the corporate Anycast CDN on apex. Public unauthenticated read, rate limited to 1,000 req/min per IP.

Method	Endpoint Path	Description	Response
`GET`	`/api/v1/health`	Cluster operational health & telemetry	`200 OK (application/json)`
`GET`	`/api/v1/nodes`	Active regional edge PoP node directory	`200 OK (application/json)`
`GET`	`/api/v1/version`	Platform software release version metadata	`200 OK (application/json)`

curl -s https://synton.cc/api/v1/health

Edge Node Control & Worker Coordination

Distributed across regional Edge PoP nodes at https://api.sfu-<region>.synton.cc/v1/.... Requires cryptographic Bearer token authentication. Rate limited to 120 req/min per Bearer token.

Method	Endpoint	Description	Authorization
`POST`	`/v1/conference/session`	Allocate conference session & worker channel	Bearer <TENANT_TOKEN>
`GET`	`/v1/media/streams`	Inspect active audio and video tracks	Bearer <TENANT_TOKEN>
`DELETE`	`/v1/conference/session/{id}`	Terminate active conference session	Bearer <TENANT_TOKEN>

curl -s -X POST https://api.sfu-X.synton.cc/v1/conference/session \
  -H "Authorization: Bearer <TENANT_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"room_id": "conf-782", "max_publishers": 8}'

API Error Response Formats

Status Code	Error Identifier	Description
`401 Unauthorized`	`{"error": "unauthorized", "message": "Valid Bearer token required"}`	Missing or invalid authentication header
`403 Forbidden`	`{"error": "forbidden", "message": "Tenant scope mismatch"}`	Token lacks permission for target cluster
`429 Too Many Requests`	`{"error": "rate_limited", "message": "Request rate limit exceeded"}`	Client exceeded rate allowance
`500 Internal Error`	`{"error": "internal_error", "message": "SFU worker subsystem unavailable"}`	Cluster worker failure