Tenant Access

Enterprise Management API Reference

HTTP REST interface for room orchestration, participant token generation, and cluster telemetry.

Public Telemetry & PoP Discovery

Unauthenticated endpoints served globally via Anycast CDN (rate limit: 1,000 req/min per IP):

Method Endpoint Description
GET /api/v1/health Global cluster health, active worker count, and operational state.
GET /api/v1/nodes Public JSON directory of active regional Edge PoP nodes.
GET /api/v1/version Control plane release version and build metadata.

Edge Node Control & Room Management

Authenticated tenant endpoints hosted on regional media clusters. Requires a Bearer token (rate limit: 120 req/min per token):

POST /v1/room/create

Allocates a new media room session on the targeted regional SFU cluster.

curl -X POST "https://signal.sfu-<region>.synton.cc/v1/room/create" \
  -H "Authorization: Bearer <TENANT_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "room_name": "quarterly-briefing",
    "empty_timeout": 300,
    "max_participants": 50
  }'

POST /v1/room/token

Issues a cryptographically signed participant session token with granular audio/video publish and subscribe permissions.

curl -X POST "https://signal.sfu-<region>.synton.cc/v1/room/token" \
  -H "Authorization: Bearer <TENANT_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "room_id": "rm_9f2a7c",
    "identity": "user_4821",
    "can_publish": true,
    "can_subscribe": true
  }'

Error Response Schemas

Standard error payload returned on unauthenticated or rejected requests:

{
  "error": "unauthorized",
  "message": "Valid Bearer token required",
  "code": 401
}
Status Code Meaning Resolution
401 Unauthorized Missing or invalid Bearer token Provide valid <TENANT_TOKEN> in Authorization header.
403 Forbidden Token lacks permission for requested action Verify room ownership in enterprise console.
429 Too Many Requests Exceeded 120 req/min rate limit Implement exponential backoff or request limit increase.
500 Internal Error Unexpected edge processing error Retry request or alert noc@synton.cc.