---
title: "Named Linux sandbox that pauses instead of dying (files, packages and running processes survive). Actions: run, write_file, read_file, sync_from_store, sync_to_store, status, pause, kill, list. Auto-pauses after 1 idle minute. Free: 3 sandboxes, 60 run-minutes/day."
method: POST
path: "/api/v1/sandbox"
tags: ["sandbox"]
---

# Named Linux sandbox that pauses instead of dying (files, packages and running processes survive). Actions: run, write_file, read_file, sync_from_store, sync_to_store, status, pause, kill, list. Auto-pauses after 1 idle minute. Free: 3 sandboxes, 60 run-minutes/day.

`POST /api/v1/sandbox`

## Request

- Base URL: `https://cloudforbots.com`
- URL: `https://cloudforbots.com/api/v1/sandbox`
- Auth: HTTP bearer

## Request body

- object
  - `action` 'run' | 'write_file' | 'read_file' | 'sync_from_store' | 'sync_to_store' | 'status' | 'pause' | 'kill' | 'list', required
  - `name` string
  - `ns` string
  - `prefix` string
  - `dir` string
  - `secrets` string[]: run: secret names usable from code via $CFB_FETCH_URL + $CFB_FETCH_TOKEN (15 min); values never enter the sandbox
  - `cmd` string
  - `cwd` string
  - `timeout_s` integer
  - `background` boolean
  - `path` string
  - `content` string
  - `content_base64` string

## Response `200`

ok

## Other responses

- `429`: free limit reached

---

[API](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api.md) · [All operations](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api/revisions/1afdb5648693?raw)