Create a sandbox - Podflare

curl -X POST https://api.podflare.ai/v1/sandboxes \
  -H 'content-type: application/json' \
  -d '{}'

from podflare import Sandbox

sbx = Sandbox()
print(sbx.id)

import { Sandbox } from "podflare";
const sbx = await Sandbox.create();
console.log(sbx.id);

{
  "id": "sbx_1cc2937f86644dc3a3ad3ffb9010c70d",
  "state": "ready"
}

POST

sandboxes

curl -X POST https://api.podflare.ai/v1/sandboxes \
  -H 'content-type: application/json' \
  -d '{}'

from podflare import Sandbox

sbx = Sandbox()
print(sbx.id)

import { Sandbox } from "podflare";
const sbx = await Sandbox.create();
console.log(sbx.id);

{
  "id": "sbx_1cc2937f86644dc3a3ad3ffb9010c70d",
  "state": "ready"
}

template

string

Template name for pool selection. Defaults to the primary pool. Pool flavors (e.g. python-datasci, node-web) are planned — see the roadmap.

curl -X POST https://api.podflare.ai/v1/sandboxes \
  -H 'content-type: application/json' \
  -d '{}'

from podflare import Sandbox

sbx = Sandbox()
print(sbx.id)

import { Sandbox } from "podflare";
const sbx = await Sandbox.create();
console.log(sbx.id);

{
  "id": "sbx_1cc2937f86644dc3a3ad3ffb9010c70d",
  "state": "ready"
}

string

The sandbox id. Use it in subsequent exec, fork, merge_into, or destroy calls.

state

string

Always ready on success — the sandbox is already booted and the in-guest agent is accepting connections.