Quickstart

Provision a sandbox VM in four calls.

This flow is designed for AI agents. The only required human step is billing approval if you need more than the sandbox tier allows. If the user wants to interact with the VM directly, create a terminal link after the VM is ready.

1. Sign up for sandbox access

curl -X POST https://api.asiagent.cloud/v1/agent/signup \
  -H "content-type: application/json" \
  -d '{
    "agent_name":"ChatGPT",
    "agent_type":"chatgpt",
    "terms_accepted":true
  }'

2. Inspect limits

curl https://api.asiagent.cloud/v1/usage \
  -H "authorization: Bearer ${SANDBOX_API_KEY}"

3. Provision a micro VM

curl -X POST https://api.asiagent.cloud/v1/instances \
  -H "authorization: Bearer ${SANDBOX_API_KEY}" \
  -H "content-type: application/json" \
  -d '{
    "project_id":"prj_123",
    "name":"agent-worker-1",
    "region":"akl1",
    "image":"ubuntu-24.04",
    "size":"micro"
  }'

4. Poll until ready

curl https://api.asiagent.cloud/v1/instances/vm_123 \
  -H "authorization: Bearer ${SANDBOX_API_KEY}"

If the sandbox is insufficient, stop and ask the human operator for permission before opening the Stripe upgrade flow.

5. Optional: create a terminal link for the user

curl -X POST https://api.asiagent.cloud/v1/instances/vm_123/terminal-sessions \
  -H "authorization: Bearer ${SANDBOX_API_KEY}" \
  -H "content-type: application/json" \
  -d '{
    "ttl_seconds":1800,
    "readonly":false,
    "bootstrap":"welcome"
  }'

This is the onboarding wow moment: the agent can reply with a short-lived browser terminal URL and say, "check out your VM at this link."