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)

Planning endpoints:

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.

Workloads

Overview

CAE

Deployments

Sim

API Directory

API Directory

External APIs

Satellite Intelligence API

Workloads API (Control Plane)

Constraint-Aware Execution (CAE)

Orbital Simulation (Sim)

Agent Protocol APIs

Summary

​API Directory

​External APIs

​Satellite Intelligence API

​Workloads API (Control Plane)

​Constraint-Aware Execution (CAE)

​Orbital Simulation (Sim)

​Agent Protocol APIs

​Summary

API Directory

External APIs

Satellite Intelligence API

Workloads API (Control Plane)

Constraint-Aware Execution (CAE)

Orbital Simulation (Sim)

Agent Protocol APIs

Summary