Skip to main content

​
Orbit API v1 🚀

Welcome to the Orbit Public API. This RESTful surface helps you automate workspace operations, sync activity, and power admin tooling. All endpoints return JSON and follow consistent success/error patterns.
Each response mirrors the workspace configuration you are scoped to, so multi-workspace teams can build predictable automations.

​
Authentication

Every request must include an Authorization header with a bearer token: 
Authorization: Bearer orbit_your_api_key_here
Create keys in Workspace → Settings → Public API and store them in a secrets manager. Keys inherit the creator’s permissions—create scoped keys per integration.

​
Rate limits

Rate limits: 100 requests/minute per API key. Bursts are smoothed with a leaky bucket—implement exponential backoff on 429 responses.

​
Versioning

Current base path: https://api.planetaryapp.us/v1/. When we publish v2, you will find everything documented under /api-references/introduction?v=2 with explicit changelog notes.

​
Jump to sections