# ascii

## Docs

- [API Keys](https://docs.ascii.dev/box/api-keys.md): Create, store, rotate, and revoke Box API keys for automation.
- [Create API key](https://docs.ascii.dev/box/api/reference/account/create-api-key.md): Creates a new API key for the authenticated Box account. The raw `secret` is returned once; store it immediately.
- [Get Box limits](https://docs.ascii.dev/box/api/reference/account/get-box-limits.md): Check quota, access readiness, and active-box capacity for the authenticated account.
- [Get Box secrets setup](https://docs.ascii.dev/box/api/reference/account/get-box-secrets-setup.md): Returns the environment variables and secret files configured for Boxes.
- [Get current Box user](https://docs.ascii.dev/box/api/reference/account/get-current-box-user.md): Returns GitHub identity for the authenticated Box account.
- [List API keys](https://docs.ascii.dev/box/api/reference/account/list-api-keys.md): Lists API key metadata only. Raw key secrets are not returned after creation/rotation. Results are scoped to the authenticated Box account.
- [List GitHub repositories available to Box](https://docs.ascii.dev/box/api/reference/account/list-github-repositories-available-to-box.md): Returns GitHub repositories grouped by installation plus the current selected repositories for new Boxes.
- [Revoke API key](https://docs.ascii.dev/box/api/reference/account/revoke-api-key.md): Revokes an API key by id. The key must belong to the authenticated Box account.
- [Rotate API key](https://docs.ascii.dev/box/api/reference/account/rotate-api-key.md): Rotates the raw secret in place and returns the new secret once. The API key id is preserved, the old secret stops working, and the key must belong to the authenticated Box account.
- [Select repository for Boxes](https://docs.ascii.dev/box/api/reference/account/select-repository-for-boxes.md): Idempotently selects one repository for the Box environment. Use `databaseId` from `GET /repos` as `repositoryId`; selecting an already-selected repository updates its `baseBranch`.
- [Update Box secrets setup](https://docs.ascii.dev/box/api/reference/account/update-box-secrets-setup.md)
- [Configure box SSH key](https://docs.ascii.dev/box/api/reference/agent/configure-box-ssh-key.md): Adds an OpenSSH public key to the running Box so the caller can SSH as user `user`.
- [Download Box artifact](https://docs.ascii.dev/box/api/reference/agent/download-box-artifact.md)
- [Execute Box command](https://docs.ascii.dev/box/api/reference/agent/execute-box-command.md)
- [Get desktop streaming URL](https://docs.ascii.dev/box/api/reference/agent/get-desktop-streaming-url.md): Create or fetch a secret-bearing desktop/noVNC URL for live computer-use visibility. Use `?vnc=1` for noVNC; a `provisioning: true` response means poll again.
- [Get prompt run status](https://docs.ascii.dev/box/api/reference/agent/get-prompt-run-status.md): Returns first-class status for a queued/running/finished prompt so clients do not infer completion from box state and events.
- [Interrupt running work](https://docs.ascii.dev/box/api/reference/agent/interrupt-running-agent-work.md)
- [List box events](https://docs.ascii.dev/box/api/reference/agent/list-box-events.md): Return Box work, lifecycle, and progress events so product UIs can show what the box is doing. Event payloads are extensible. Clients can long-poll this endpoint with `sort=asc` and a cursor to stream responses. Response events expose agent text, streaming partials via `data.is_streaming`, and tool…
- [Prompt Box](https://docs.ascii.dev/box/api/reference/agent/prompt-box-agent.md): Queue a natural-language work item for Codex or Claude Code inside the box. Observe progress with `GET /boxes/{boxId}/events`.
- [Read Box file](https://docs.ascii.dev/box/api/reference/agent/read-box-file.md)
- [Write Box file](https://docs.ascii.dev/box/api/reference/agent/write-box-file.md)
- [Create box](https://docs.ascii.dev/box/api/reference/boxes/create-box.md): Provision a new cloud computer. Store the returned `box.id` with your product job/session record.
- [Delete box](https://docs.ascii.dev/box/api/reference/boxes/delete-box.md)
- [Fork box](https://docs.ascii.dev/box/api/reference/boxes/fork-box.md)
- [Get box](https://docs.ascii.dev/box/api/reference/boxes/get-box.md): Poll this endpoint after create, stop, resume, or fork operations.
- [List boxes](https://docs.ascii.dev/box/api/reference/boxes/list-boxes.md)
- [Resume box](https://docs.ascii.dev/box/api/reference/boxes/resume-box.md)
- [Stop and archive box](https://docs.ascii.dev/box/api/reference/boxes/stop-and-archive-box.md): Stop active work and archive/snapshot the box for later resume or fork.
- [Update box](https://docs.ascii.dev/box/api/reference/boxes/update-box.md)
- [Box Public API v1](https://docs.ascii.dev/box/api/v1.md): Create, manage, prompt, observe, and expose Box sandboxes from your own products.
- [CLI Reference](https://docs.ascii.dev/box/cli-reference.md): Complete reference for all box CLI commands and global flags.
- [Desktop Streaming](https://docs.ascii.dev/box/desktop-streaming.md): How Box opens a browser-based desktop stream for GUI work.
- [Host with box](https://docs.ascii.dev/box/hosting.md): Run a service inside a Box and expose it on a stable public HTTPS URL.
- [Long-Running Tasks](https://docs.ascii.dev/box/long-running-tasks.md): Keep a Box running longer and restart processes after resume or fork.
- [Machine Capabilities](https://docs.ascii.dev/box/machines.md): What's pre-installed on every box and what you can do with it.
- [Quickstart](https://docs.ascii.dev/box/quickstart.md): Install Box, finish onboarding, and start your first cloud sandbox.
- [Repositories](https://docs.ascii.dev/box/repositories.md): Choose which GitHub repositories Box clones into each VM.
- [Box SDKs](https://docs.ascii.dev/box/sdks/overview.md): Use Box from Python and TypeScript/JavaScript services.
- [Python SDK](https://docs.ascii.dev/box/sdks/python.md): Install, configure, and use the ascii-box-sdk Python package.
- [TypeScript and JavaScript SDK](https://docs.ascii.dev/box/sdks/typescript.md): Install, configure, and use the @asciidev/box-sdk npm package.
- [Secrets & Setup](https://docs.ascii.dev/box/secrets.md): Add secrets, run setup scripts, and restart services in Boxes.
- [SSH Access](https://docs.ascii.dev/box/ssh-access.md): Connect to a Box over SSH from your terminal or external tools.
- [Use in Code](https://docs.ascii.dev/box/use-in-code.md): Call Box from scripts and applications by wrapping the CLI with --json.
- [Use in Docker](https://docs.ascii.dev/box/use-in-production.md): Install Box in Docker images and authenticate the CLI with an API key.

## OpenAPI Specs

- [box-v1](https://docs.ascii.dev/openapi/box-v1.yaml)
- [openapi](https://docs.ascii.dev/api-reference/openapi.json)