Atlas: Overview

Atlas API Overview

Atlas is the public API layer for sandbox lifecycle, templates, runtime profiles, source bootstrap, and provider capacity.

This portal documents the public surface exposed by the Atlas public API. The runtime implementation still lives in the hopx-control-plane repository during the migration.

Base URL

  • Current production: https://hopx-api.euphile.eu
  • Target Atlas production hostname: https://api.euphile.eu

What You Can Do

  • inspect provider catalog and capacity
  • manage runtime profiles and template aliases
  • manage source connections
  • create, inspect, start, stop, retry, and delete sandboxes
  • reconcile provisioning jobs and sandbox batches

Public vs Internal APIs

The public /v1/* API is documented here.

The Firecracker scheduler and host-agent APIs are internal contracts and are documented separately in scalar.internal.config.json.

Design Notes

  • the public API is operator-facing and authenticated with euphile-key
  • provider ids remain hopx and firecracker
  • provider internals are deliberately hidden behind one control-plane surface
  • Firecracker remains exposed through the public control plane, not through direct client access to the scheduler or host agents