# PPIO Docs > Documentation for PPIO Model API and Agent Sandbox. - [PPIO Model API and Agent Sandbox](https://docs.ppio.ai/index.md): Send a first Model API request, then find guides for Model API, Agent Sandbox, integrations, and the platform, plus the changelog, errors, and FAQ. - [Quickstart](https://docs.ppio.ai/quickstart.md): Create an API key, store it in an environment variable, send a chat completions request with cURL, Python, or Node.js, and read token usage in the console. - [Model API overview](https://docs.ppio.ai/model-api/overview.md): Placeholder. Content lands with the first content batch. - [Agent Sandbox: secure cloud sandboxes for AI agents](https://docs.ppio.ai/sandbox/overview.md): Run agent code, browsers and files in isolated cloud sandboxes through a Python or Node.js SDK, and keep state between sessions without managing infrastructure. - [Create your first sandbox](https://docs.ppio.ai/sandbox/quickstart.md): Create a PPIO API key, install the Agent Sandbox SDK for Python or Node.js, set two environment variables, and run your first sandbox program. - [How Agent Sandbox billing works](https://docs.ppio.ai/sandbox/billing.md): See which sandbox resources are metered, how paused and killed sandboxes are billed, where usage and bills appear, and what an overdue balance does. - [Agent Sandbox quotas and limits](https://docs.ppio.ai/sandbox/quotas.md): Learn which limit each sandbox quota governs, how to check current values and usage in the console or the SDK, and how to request a higher limit for a team. - [Manage sandboxes in the PPIO console](https://docs.ppio.ai/sandbox/console.md): Use the AGENT SANDBOX pages of the PPIO console to inspect running sandboxes, browse templates, track usage and quotas, and save a sandbox as a snapshot. - [Sandbox lifecycle and states](https://docs.ppio.ai/sandbox/lifecycle.md): A sandbox moves through the Running, Paused, and Killed states. This page covers the transitions, the timeout and idle timeout settings, and the SDK defaults. - [Create a sandbox](https://docs.ppio.ai/sandbox/create.md): Create a sandbox from the default or a named template, set the timeout, environment variables and metadata, and find the sandbox again by its metadata. - [Connect to a running sandbox](https://docs.ppio.ai/sandbox/connect.md): Find the ID of a running sandbox with the SDK, then connect to it with ppio.sandbox.connect() from another function invocation, session, or process. - [List and filter sandboxes](https://docs.ppio.ai/sandbox/list.md): List running and paused sandboxes, filter by state and metadata on the server, and page through results with the SDK or with ppio sandbox list. - [Set or extend a sandbox timeout](https://docs.ppio.ai/sandbox/timeout.md): Set the maximum lifetime of a sandbox at creation, extend it while the sandbox runs, choose pause instead of kill, and lift the cap with long-running mode. - [Configure an idle timeout](https://docs.ppio.ai/sandbox/idle-timeout.md): Stop or pause a sandbox automatically when no client is connected, by setting the idle_timeout metadata key, and combine it with other metadata keys. - [Pause and resume a sandbox](https://docs.ppio.ai/sandbox/pause-resume.md): Pause a sandbox to stop compute billing while its filesystem and memory are kept, resume it later with the same state, or pause and resume automatically. - [Save and restore sandbox state with snapshots](https://docs.ppio.ai/sandbox/snapshots.md): Create a snapshot of a running sandbox, start new sandboxes from it, list and filter snapshots, and delete the ones no longer needed. - [Kill a sandbox](https://docs.ppio.ai/sandbox/kill.md): Shut down a sandbox permanently from a connected handle, by sandbox ID, or in bulk from the CLI, alone or filtered by state and metadata. - [Monitor sandbox CPU, memory, and disk](https://docs.ppio.ai/sandbox/metrics.md): Read timestamped CPU, memory, and disk records for a sandbox from the SDK or the CLI, stream them continuously, and get them as machine-readable JSON. - [Query sandbox lifecycle events](https://docs.ppio.ai/sandbox/events.md): Query a team's sandbox lifecycle events for troubleshooting, auditing and billing reconciliation, filtered by sandbox, template, event type and time range. - [Run commands in a sandbox](https://docs.ppio.ai/sandbox/commands.md): Run terminal commands inside a sandbox, read stdout and stderr, start background processes, override environment variables, and stream output as it arrives. - [Open an interactive terminal (PTY)](https://docs.ppio.ai/sandbox/terminal.md): Create a pseudo-terminal in a sandbox, send input, resize it, reconnect by pid, and kill it, for REPLs, debuggers and interactive command line tools. - [Work with files in a sandbox](https://docs.ppio.ai/sandbox/filesystem/overview.md): Read, write, upload, download and watch files in the isolated sandbox filesystem, and mount an S3 bucket or read file and directory metadata with the SDK. - [Read and write files](https://docs.ppio.ai/sandbox/filesystem/read-write.md): Read a file from the sandbox filesystem with files.read(), and write one file or several files in a single call with files.write() in Python or Node.js. - [Get file and directory metadata](https://docs.ppio.ai/sandbox/filesystem/metadata.md): Get the name, type, path, size, permissions, owner, group and modified time of a file or directory in a sandbox with get_info() or getInfo(). - [Watch a directory for changes](https://docs.ppio.ai/sandbox/filesystem/watch.md): Watch a sandbox directory for create, write, remove, rename and chmod events with Node.js callbacks, Python async callbacks or Python sync polling. - [Upload files to a sandbox](https://docs.ppio.ai/sandbox/filesystem/upload.md): Upload a single local file, a directory or several files to a sandbox with files.write(), or let a browser upload through a pre-signed URL. - [Download files from a sandbox](https://docs.ppio.ai/sandbox/filesystem/download.md): Copy a file from a sandbox to the local filesystem with files.read() as bytes, or generate a short-lived pre-signed download URL for a browser. - [Mount an S3 bucket in a sandbox](https://docs.ppio.ai/sandbox/filesystem/mount-s3.md): Mount an Amazon S3 bucket inside a sandbox with s3fs-fuse installed in a template Dockerfile, so data outlives the sandbox temporary disk. - [Control internet access and expose ports](https://docs.ppio.ai/sandbox/internet-access.md): Turn internet access on or off, set outbound allowlists and denylists, expose a service through the sandbox URL, and mask request Host headers. - [Secure access to sandbox services](https://docs.ppio.ai/sandbox/secured-access.md): Understand secure SDK access and traffic access tokens for sandbox URLs, require a token on every request, and change the settings on a sandbox. - [What is a sandbox template?](https://docs.ppio.ai/sandbox/templates/overview.md): A template is the blueprint a sandbox starts from: base image, packages, files, environment and startup commands, compared with snapshots and Dockerfiles. - [Build a template with the SDK](https://docs.ppio.ai/sandbox/templates/build.md): Define a template with the SDK builder, build it, and create a sandbox from the result: base image, build steps, packages, caching, tags and size. - [Build a template with the CLI](https://docs.ppio.ai/sandbox/templates/build-cli.md): Build a Dockerfile into a reusable sandbox template with ppio template create, setting the start and ready commands, CPU count, memory and build cache. - [List, tag, publish, and delete templates](https://docs.ppio.ai/sandbox/templates/manage.md): List sandbox templates and read the paginated response, assign or remove release tags, publish a template, and delete a template by ID from the SDK or CLI. - [Use Git in a sandbox](https://docs.ppio.ai/sandbox/git.md): Clone, branch, commit, pull and push repositories inside a sandbox with the git helpers, including credentials, commit identity, remotes and config. - [Run a desktop sandbox for computer use](https://docs.ppio.ai/sandbox/computer-use.md): Start a desktop sandbox, activate its desktop stream, and read interactive or view-only VNC URLs that open in a browser for computer use agents. - [Connect a sandbox to a VPN with OpenVPN](https://docs.ppio.ai/sandbox/openvpn.md): Install OpenVPN in a sandbox, upload a .ovpn client profile, start the tunnel in the background, and confirm that the tun0 interface is up. - [Install and sign in to the PPIO CLI](https://docs.ppio.ai/sandbox/cli/install.md): Install the ppio-sandbox-cli package, point the CLI at the PPIO Agent Sandbox service, check the API key, and sign in through the browser. - [ppio sandbox connect](https://docs.ppio.ai/sandbox/cli/connect.md): Attach an interactive remote shell to a running sandbox over a PTY, stream commands and their output, and exit without stopping the sandbox. - [ppio sandbox exec](https://docs.ppio.ai/sandbox/cli/exec.md): Run one-off commands in a running sandbox from the CLI, with a working directory, a user and environment variables, in the background or with piped input. - [ppio sandbox network](https://docs.ppio.ai/sandbox/cli/network.md): Update the egress rules of a running sandbox from the CLI, allowing or denying outbound destinations by IP address or CIDR range, or clearing every rule. - [Agent Sandbox errors](https://docs.ppio.ai/sandbox/errors.md): Reference for the exceptions the Agent Sandbox SDK raises, the API status codes behind them, and the CLI messages and exit codes reported by a failed command. - [Console overview](https://docs.ppio.ai/platform/console.md): Placeholder. Content lands with the first content batch. - [API Reference](https://docs.ppio.ai/api-reference/introduction.md): Placeholder. Content lands with the first content batch. - [Changelog](https://docs.ppio.ai/changelog.md): Placeholder. Content lands with the first content batch. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.