API Directory
RotaStellar exposes three categories of public APIs across multiple services. Each service is independently deployed and has its own base URL.
Internal Console APIs (session-authenticated) are documented in Mission Control > Admin > API Directory for authorized operators only.
External APIs
Public APIs requiring a Bearer API key (rs_...). Available to all developers.
Satellite Intelligence API
Base URL: https://api.rotastellar.com/v1
Auth: Bearer API key
Docs: Full reference →
| Method | Endpoint | Description |
|---|
| GET | /satellites/active | Active satellites with live orbital data |
| GET | /satellites | List satellites with filters |
| GET | /satellites/{id} | Satellite details |
| GET | /satellites/{id}/position | Current position (lat/lon/alt) |
| GET | /satellites/{id}/orbit | Orbital parameters |
| GET | /satellites/{id}/visibility | Ground station visibility |
| GET | /satellites/{id}/passes | Predict ground passes |
| GET | /satellites/{id}/feasibility | Compute feasibility analysis |
| GET | /satellites/{id}/latency | Communication latency analysis |
| GET | /conjunctions | Conjunction (collision) analysis |
| GET | /patterns | Anomaly and maneuver detection |
| GET | /ground-stations | Ground station network (12 stations) |
| Method | Endpoint | Description |
|---|
| POST | /planning/analyze | Feasibility analysis |
| POST | /planning/thermal | Thermal simulation |
| POST | /planning/latency | Latency simulation |
15 endpoints — Intelligence + Planning
Workloads API (Control Plane)
The developer API to run, track, and control workloads on the orbital fleet. One submission surface — the workload class (single, data-parallel, spatial, federated, model-parallel, split-learning) drives execution; the CAE places it and the durable lifecycle runs it.
Base URL: https://api.rotastellar.com/v1
Auth: Bearer API key
| Method | Endpoint | Description |
|---|
| POST | /v1/workloads | Submit (run) a workload of any class |
| POST | /v1/workloads/preview | Plan — the CAE verdict (feasibility + cut/partition + ISL-bound) + cost estimate, without running |
| GET | /v1/workloads | List your workloads (newest first) |
| GET | /v1/workloads/{id} | Status + placement + outcome (poll phase) |
| GET | /v1/workloads/{id}/stages | Per-satellite execution — which satellite ran each stage |
| GET | /v1/workloads/{id}/artifacts | The result manifest (outputs + how to fetch each) |
| POST | /v1/workloads/{id}/cancel | Stop a queued/running workload |
7 endpoints — plan → run → track → retrieve → cancel. A frontier workload (model-parallel / split-learning) runs as a pipeline across the constellation; distributed-training is ISL-bound, so it’s preview-only. Full guide: Workloads →.
Constraint-Aware Execution (CAE)
Base URL: https://rotastellar-cae.subhadip-mitra.workers.dev
Auth: None (CORS-restricted to allowed origins)
Docs: CAE reference →
| Method | Endpoint | Description |
|---|
| GET | /v1 | Service index and capabilities |
| GET | /v1/presets | List workload presets |
| POST | /v1/plan | Create execution plan (single satellite) |
| GET | /v1/plan/{id} | Retrieve a plan |
| GET | /v1/plan/{id}/events | Simulated execution events |
| POST | /v1/ocu/negotiate | OCU Negotiator — match workload to fleet |
| GET | /v1/ocu/summary/{busClass} | OCU capacity for a satellite class |
| POST | /v1/hazards | Predict orbital hazards + checkpoints |
| POST | /v1/constellation/plan | Multi-satellite DAG planning with ISL |
| POST | /v1/constellation/pareto | Fleet-level Pareto frontier planning |
| GET | /v1/metrics | Worker performance metrics |
11 endpoints — Orbital compute orchestration
Orbital Simulation (Sim)
Base URL: https://sim.rotastellar.com
Auth: None (CORS-restricted)
Docs: Sim reference →
| Method | Endpoint | Description |
|---|
| POST | /v1/state | Orbital state at a timestamp |
| POST | /v1/state/batch | Batch state for multiple satellites |
| POST | /v1/propagate | Full trajectory over time window |
| POST | /v1/passes | Ground station pass computation |
| POST | /v1/orbital-params | Orbital parameters from altitude |
| GET | /v1/templates | Orbit templates |
| GET | /v1/constellation-templates | Constellation patterns |
| POST | /v1/constellation-templates/{id}/expand | Generate satellite definitions |
| GET | /v1/ground-stations | Ground station network |
9 endpoints — Stateless orbital computation
Agent Protocol APIs
APIs used by the RotaStellar Operator Agent running on satellites (real or simulated). Authenticated via API key + Agent-ID headers.
Base URL: Console URL (e.g., https://rotastellar.com)
Auth: X-API-Key + X-Agent-ID headers
Docs: Agent Protocol →
| Method | Endpoint | Description |
|---|
| POST | /api/agent/register | Register agent with Console |
| GET | /api/agent/workloads | Poll for pending deployments |
| POST | /api/agent/telemetry | Report health/status heartbeat |
| POST | /api/deployments/{id}/events | Report execution events |
4 endpoints — Pull-based satellite agent protocol
Summary
| Service | Endpoints | Auth Method | Base URL |
|---|
| Intelligence API | 15 | Bearer API key | api.rotastellar.com/v1 |
| Workloads API (Control Plane) | 7 | Bearer API key | api.rotastellar.com/v1 |
| CAE | 11 | CORS-restricted | rotastellar-cae.workers.dev |
| Sim | 9 | CORS-restricted | sim.rotastellar.com |
| Agent Protocol | 4 | API key + Agent-ID | Console URL |
| Total | 46 | | |
Internal Console APIs (88 routes for auth, billing, admin, missions, etc.) are documented in the Console’s Admin > API Directory page, accessible to authenticated administrators only.
