Skip to main content
A Sailbox is a Linux VM on the Sail (Sail Research) platform: a full cloud environment designed for long-horizon agents. The following table shows what CostGraph runs on this provider.

​
Connect

Run the dispatcher with provider set to sail and these variables:
  • SAIL_API_KEY
CostGraph does not set a size or a lifetime on Sail. Sailboxes boot arm64 by default. If you connected Sail for cost data, CostGraph’s dispatcher can start sandboxes with the key from your Sail integration. That key then needs the permissions in the next section as well.

​
Key and permissions

SAIL_API_KEY is a Sail API key created in the Sail dashboard (app.sailresearch.com); bearer auth against https://sailbox-api.sailresearch.com/v1. A key is either user-minted or tied to the organization (whoami returns user_id null for org keys). No per-key scopes documented: a key belongs to one organization and sees that organization’s Sailboxes. Use an organization-scoped (service) key so all Sailboxes it creates are operable by it; private-visibility Sailboxes require a user-minted key and only the creator can operate them. Sources: docs.sailresearch.com: sailboxes http api, docs.sailresearch.com: sailbox sdk, docs.sailresearch.com: whoami.

​
Limits

  • Max lifetime optional: omit for unlimited lifetime; when set, the Sailbox is permanently terminated at expiry. (source)
  • Idle sleep: Sail sleeps a Sailbox only when nothing would notice (no CPU/network activity, no open connections); an idle shell does not keep it awake. (source)
  • 1-8 vCPU (default 8); memory up to 256 GiB; disk 8-1024 GiB. (source)
  • Prebuilt Debian images for arm64 and amd64; volumes are Alpha; regions not documented. (source)
  • New organizations have in-flight requests capped for their first ten minutes (429); exec body max 25 MiB. (source)