API Reference

NextEpoch Cloud exposes HTTP APIs for interacting with the platform programmatically.

Services

Service	Base URL	Description
Air	`https://air.nextepoch.cloud`	Communications mesh and telemetry ingestion
Insights	`https://insights.nextepoch.cloud`	SQL queries over telemetry data
Storage	`https://storage.nextepoch.cloud`	Object storage for file uploads and downloads

All API endpoints require a JWT token obtained through the Identity service's OAuth 2.1 flow. Include it in the Authorization header:

bash

Authorization: Bearer <your-jwt-token>

See the Identity API for details on the OAuth 2.1 authorization and token endpoints.

All API responses follow a consistent JSON structure:

json

{
  "data": { ... },
  "meta": {
    "request_id": "req_abc123"
  }
}

Error responses:

json

{
  "error": {
    "code": "not_found",
    "message": "Resource not found"
  }
}

API requests are rate-limited per organization. Rate limit headers are included in all responses:

X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 9995
X-RateLimit-Reset: 1705312800