# Documentation > Blaxel documentation: cloud sandboxes, AI agent hosting, MCP servers, batch jobs, and model gateway for building and deploying AI-powered applications. - [Blaxel: infrastructure for autonomous agents](https://docs.blaxel.ai/Overview.md): Introduction to Blaxel core building blocks: perpetual sandboxes, Agent Drive shared filesystem, and networking primitives. - [Get started](https://docs.blaxel.ai/Get-started.md): Step-by-step quickstart guide to install the Blaxel CLI, create a cloud sandbox, run processes, manage files, and deploy your first AI agent. - [Blaxel Skills & MCP](https://docs.blaxel.ai/skills-mcp.md): Connect Claude, Codex, Cursor, Claude Code, Windsurf, or other AI assistants to manage your Blaxel resources and search the Blaxel docs via MCP. - [Community](https://docs.blaxel.ai/Community.md): Join the Blaxel community to ask questions, get support, and connect with other developers building AI agents and sandboxes on Blaxel. - [Sandboxes](https://docs.blaxel.ai/Sandboxes/Overview.md): Run LLM-generated code in lightweight, sandboxed virtual machines with sub-25ms cold starts, file system, processes, and an MCP server for agents. - [Expiration policies](https://docs.blaxel.ai/Sandboxes/Expiration.md): Configure expiration policies to automatically delete Blaxel sandboxes after inactivity, a TTL, or other conditions to control snapshot storage costs. - [Lifecycle signals](https://docs.blaxel.ai/Sandboxes/Lifecycle-signals.md): Let sandbox code clean up before deletion and prepare before standby with SIGTERM and SIGUSR2 grace periods. - [Process execution](https://docs.blaxel.ai/Sandboxes/Processes.md): Execute shell commands, retrieve process information, stream output, and control process lifecycle in Blaxel sandboxes using the SDK. - [File system](https://docs.blaxel.ai/Sandboxes/Filesystem.md): Read, write, list, and delete files inside a Blaxel sandbox using a simple file system interface from the SDK, MCP server, or REST API. - [Code generation tools](https://docs.blaxel.ai/Sandboxes/Codegen-tools.md): Use Blaxel sandbox tools and functions optimized for AI code generation, including file editing, formatting, search, and execution helpers. - [Log streaming](https://docs.blaxel.ai/Sandboxes/Log-streaming.md): Retrieve process output logs from sandboxes in batch or real-time streaming mode using the Blaxel SDK in TypeScript, Python, or Go. - [Snapshots and forking](https://docs.blaxel.ai/Sandboxes/Fork.md): Create point-in-time snapshots of sandboxes, roll them back to a checkpoint, and fork them into new sandboxes. - [Archive and unarchive sandboxes](https://docs.blaxel.ai/Sandboxes/Archive.md): Archive a sandbox to keep its filesystem while shutting it down, and unarchive it later to get it back. - [Ports](https://docs.blaxel.ai/Sandboxes/Ports.md): Expose specific TCP ports on a Blaxel sandbox so external clients can connect to web servers, dev servers, or other services running inside it. - [Real-time previews](https://docs.blaxel.ai/Sandboxes/Preview-url.md): Render an application in real-time through a direct preview URL backed by a running Blaxel sandbox, with optional auth and custom domains. - [Handle CORS on Blaxel](https://docs.blaxel.ai/Sandboxes/CORS.md): Configure CORS headers on Blaxel preview URLs so browser frontends on another origin can call your sandbox applications, including with credentials. - [Client-side sessions](https://docs.blaxel.ai/Sandboxes/Sessions.md): Operate Blaxel sandboxes directly from a frontend client using time-limited, scoped session tokens generated by your backend, with no proxy needed. - [Standby control](https://docs.blaxel.ai/Sandboxes/Standby-control.md): Control when sandboxes remain active by managing WebSocket connections, tab visibility, auto-disconnect behavior, and activity-based timeouts. - [Sandbox schedules](https://docs.blaxel.ai/Sandboxes/Schedules.md): Run a command inside a Blaxel sandbox on a recurring cron schedule, a future datetime, or after a delay, with execution history per run. - [Proxy](https://docs.blaxel.ai/Sandboxes/Proxy.md): Route outbound sandbox traffic through Blaxel's proxy with MITM header and body injection, inject secrets, and configure per-domain firewalls. - [Proxy routing with secrets injection](https://docs.blaxel.ai/Sandboxes/Proxy-secrets-injection.md): Inject secrets, dynamic values, headers, and body fields into outbound sandbox requests through the Blaxel proxy so code never sees raw API keys or credentials. - [Domain filtering](https://docs.blaxel.ai/Sandboxes/Proxy-domains.md): Restrict which external domains, HTTP methods, and URL paths a Blaxel sandbox can reach using allowlists and denylists to prevent data exfiltration and unwanted outbound traffic. - [Volumes for sandboxes](https://docs.blaxel.ai/Sandboxes/Volumes.md): Attach Blaxel Volumes to sandboxes for persistent storage that survives sandbox destruction and recreation, with mount path configuration. - [Build reusable sandbox images with Dockerfiles](https://docs.blaxel.ai/Sandboxes/Templates.md): Create reusable sandbox images with pre-configured tools, languages, and frameworks using Dockerfiles. Deploy new sandboxes from images in seconds. - [Run sandbox workloads as a non-root user](https://docs.blaxel.ai/Sandboxes/Non-root-user.md): Scope everything a sandbox runs on your behalf to an unprivileged user, and refuse calls from that user to the sandbox API. - [Sandbox variables and secrets](https://docs.blaxel.ai/Sandboxes/Variables-and-secrets.md): Configure environment variables and secrets in Blaxel sandboxes to securely manage API keys, credentials, and runtime configuration values. - [Sandbox MCP server](https://docs.blaxel.ai/Sandboxes/MCP.md): Every Blaxel sandbox exposes a built-in MCP server so agents can operate the sandbox using tool calls for files, processes, ports, and previews. - [Sandbox best practices](https://docs.blaxel.ai/Sandboxes/best-practices.md): Recommended practices for sandbox lifecycle management, scale-to-zero behavior, persistent storage, agent architecture, and MCP server design. - [Agent Drive overview](https://docs.blaxel.ai/Agent-drive/Overview.md): Agent Drive is a distributed filesystem mountable to multiple sandboxes or agents simultaneously, with concurrent read-write access and built-in replication. - [Drive permissions](https://docs.blaxel.ai/Agent-drive/Permissions.md): Configure label-based ACL rules on an Agent Drive to grant sandboxes, agents, or jobs read or read-write access, scoped to specific paths. - [Access Agent Drive over S3](https://docs.blaxel.ai/Agent-drive/S3-endpoint.md): Access an Agent Drive instance from S3-compatible clients using its HTTP endpoint, service account credentials, and SigV4 signing. - [Volumes](https://docs.blaxel.ai/Volumes/Overview.md): Attach Blaxel volumes to sandboxes and other resources for persistent storage that survives recreation, enabling stateful environments. - [Volume templates](https://docs.blaxel.ai/Volumes/Volumes-templates.md): Create volume templates pre-populated with files, dependencies, or datasets so new Blaxel sandboxes and resources start with environments ready to use. - [Jobs](https://docs.blaxel.ai/Jobs/Overview.md): Run batch processing tasks for AI workflows on Blaxel as scheduled or on-demand jobs that scale automatically and run on serverless infrastructure. - [Develop a job](https://docs.blaxel.ai/Jobs/Develop-a-job.md): Initialize, develop, and locally test batch processing jobs using the Blaxel CLI and SDK in TypeScript or Python before deploying them. - [Deploy jobs](https://docs.blaxel.ai/Jobs/Deploy-a-job.md): Deploy batch jobs on Blaxel as serverless, autoscalable workloads using the CLI, GitHub integration, or Dockerfile-based deployments. - [Deploy jobs with a Dockerfile](https://docs.blaxel.ai/Jobs/Deploy-dockerfile-jobs.md): Ship a Blaxel batch job using your own custom Dockerfile to control the runtime environment, system dependencies, and the entire build process. - [Deploy multiple jobs from a mono-repo](https://docs.blaxel.ai/Jobs/Deploy-multiple-jobs.md): Deploy multiple Blaxel batch jobs from a single mono-repo with shared configuration, dependencies, and context to streamline complex workflows. - [Deploy multiple jobs from a single image](https://docs.blaxel.ai/Jobs/Deploy-shared-image.md): Build a Blaxel job image once and reuse it across multiple job definitions with different memory, disk, or region profiles, with no rebuilds. - [Manage job execution in TypeScript](https://docs.blaxel.ai/Jobs/Manage-job-execution-ts.md): Use the Blaxel TypeScript SDK to start, monitor, retry, and cancel batch job executions, with examples for input data and execution state. - [Manage job execution in Python](https://docs.blaxel.ai/Jobs/Manage-job-execution-py.md): Use the Blaxel Python SDK to start, monitor, retry, and cancel batch job executions, with examples for handling input data and execution state. - [Variables and secrets for jobs](https://docs.blaxel.ai/Jobs/Variables-and-secrets-jobs.md): Configure environment variables and secrets for Blaxel batch jobs to securely manage API keys, credentials, and runtime configuration values. - [Applications](https://docs.blaxel.ai/Applications/Overview.md): Serve AI-generated code as publicly accessible endpoints with revision management and custom URLs. - [MCP servers](https://docs.blaxel.ai/Functions/Overview.md): Deploy MCP servers on Blaxel as serverless, autoscalable APIs to equip your AI agents with tools, integrations, and external system access. - [Quickstart: Adapt an existing MCP server for Blaxel](https://docs.blaxel.ai/Functions/Adapt-Existing-MCP-server.md): Step-by-step guide to convert an existing stdio-based MCP server to streamable HTTP transport so you can deploy and host it on Blaxel. - [Quickstart: Develop a custom MCP server](https://docs.blaxel.ai/Functions/Create-MCP-server.md): Develop custom MCP servers in TypeScript or Python using Blaxel SDK, with local testing via MCP Inspector and one-command deployment. - [Deploy custom MCP servers](https://docs.blaxel.ai/Functions/Deploy-a-function.md): Host custom MCP servers on Blaxel as serverless, autoscalable endpoints with the CLI, GitHub integration, or Dockerfile-based deployments. - [Query MCP servers](https://docs.blaxel.ai/Functions/Invoke-functions.md): Connect to MCP servers deployed on Blaxel via streamable HTTP endpoints. Covers authentication, public access, and integration with agents and apps. - [Code mode](https://docs.blaxel.ai/Functions/Code-mode.md): Turn any OpenAPI specification into a code mode MCP server on Blaxel, letting agents call tools by executing TypeScript code in a sandbox. - [Variables and secrets for MCP servers](https://docs.blaxel.ai/Functions/Variables-and-secrets.md): Configure environment variables and secrets for Blaxel MCP servers to securely store API keys, credentials, and runtime configuration values. - [OAuth flow for integrations](https://docs.blaxel.ai/Functions/oauth-flow.md): Set up a user-facing OAuth flow so end-users can authorize integration connections to third-party services through your Blaxel application. - [Model APIs](https://docs.blaxel.ai/Models/Overview.md): Connect external model API providers or deploy custom models on Blaxel for unified gateway access with centralized credentials and observability. - [External model APIs](https://docs.blaxel.ai/Models/External-model-apis.md): Control and secure agent access to AI models from OpenAI, Anthropic, Mistral, and other top providers behind the Blaxel Global Inference Network. - [Query a model API](https://docs.blaxel.ai/Models/Query-a-model.md): Make inference requests to model APIs via their global endpoints on the Global Agentics Network, with ChatCompletions and custom sub-endpoint support. - [Logs & traces](https://docs.blaxel.ai/Observability/Overview.md): Get automatic logging, distributed tracing, and real-time metrics including latency, token usage, and request data for agents deployed on Blaxel. - [Integrations](https://docs.blaxel.ai/Integrations.md): Browse Blaxel integrations that connect your agents to LLM providers, SaaS apps, databases, and private APIs through pre-built MCP servers. - [OpenAI integration](https://docs.blaxel.ai/Integrations/OpenAI.md): Set up the OpenAI integration on Blaxel to call OpenAI models through a unified endpoint with centralized access control and observability. - [Anthropic integration](https://docs.blaxel.ai/Integrations/Anthropic.md): Set up the Anthropic integration on Blaxel to call Claude models through a unified endpoint with centralized access control and observability. - [Mistral AI integration](https://docs.blaxel.ai/Integrations/MistralAI.md): Set up the Mistral AI integration on Blaxel to call Mistral models through a unified endpoint with centralized access control and observability. - [Cohere integration](https://docs.blaxel.ai/Integrations/Cohere.md): Set up the Cohere integration on Blaxel to call Cohere models through a unified endpoint with centralized access control and observability. - [xAI integration](https://docs.blaxel.ai/Integrations/xAI.md): Set up the xAI integration on Blaxel to call xAI models through a unified endpoint with centralized access control and observability. - [DeepSeek integration](https://docs.blaxel.ai/Integrations/DeepSeek.md): Set up the DeepSeek integration on Blaxel to call DeepSeek models through a unified endpoint with centralized access control and observability. - [HuggingFace integration](https://docs.blaxel.ai/Integrations/HuggingFace.md): Deploy public or private AI models from Hugging Face on Blaxel and serve them as auto-scalable inference endpoints for your agents. - [Azure AI Foundry integration](https://docs.blaxel.ai/Integrations/Azure-AI-Foundry.md): Connect your Blaxel agents to LLMs deployed in Azure AI Inference, Azure OpenAI Service, and Azure AI Services through the Foundry integration. - [Google Maps](https://docs.blaxel.ai/Integrations/Google-Maps.md): Connect the Google Maps API to your Blaxel agents to enable geocoding, directions, place search, and other location-based capabilities. - [Gmail](https://docs.blaxel.ai/Integrations/Gmail.md): Connect Gmail to your Blaxel agents to give them email communication capabilities, including reading, drafting, and sending messages. - [OpenAI Agents API on Blaxel](https://docs.blaxel.ai/Integrations/OpenAI-Agents-API.md): Connect OpenAI-hosted agents to Blaxel computers, retain useful files with Agent Drive, and choose the cookbook execution mode for your application. - [AgentMail](https://docs.blaxel.ai/Integrations/AgentMail.md): Use AgentMail with Blaxel to build an intelligent assistant that autonomously answers technical questions over email through agentic inboxes. - [Rippletide](https://docs.blaxel.ai/Integrations/Rippletide.md): Combine Rippletide guardrails with Blaxel sandboxes to enforce agent safety, prevent hallucinations, and run trusted agent code securely. - [Workspaces, users and roles](https://docs.blaxel.ai/Security/Workspace-access-control.md): Manage Blaxel workspaces, invite users, assign roles, and configure access control to share resources securely across your organization. - [Baseten managed workspaces](https://docs.blaxel.ai/Security/Baseten-managed-workspaces.md): Connect your Baseten organization to a managed Blaxel workspace and manage access and account settings. - [Service accounts](https://docs.blaxel.ai/Security/Service-accounts.md): Use Blaxel service accounts with non-user API credentials to automate the full life-cycle of resources in CI/CD pipelines and backend systems. - [Access tokens](https://docs.blaxel.ai/Security/Access-tokens.md): Authenticate to Blaxel APIs and the CLI using personal access tokens, with guidance on creating, scoping, rotating, and revoking tokens securely. - [auth.md](https://docs.blaxel.ai/auth.md): Machine-readable guide that tells AI agents which Blaxel authentication methods exist today and how to use them without asking users to paste long-lived secrets. - [Billing Explorer API](https://docs.blaxel.ai/Security/Billing-Explorer-API.md): Programmatically retrieve cost and usage metrics for your Blaxel account through the Billing Explorer API, with auth and request examples. - [Domain capture](https://docs.blaxel.ai/Security/Domain-capture.md): Verify your company's email domain on Blaxel to control which login methods your team can use and automatically onboard new users to workspaces. - [SAML & Directory Sync](https://docs.blaxel.ai/Security/SSO-Directory-sync.md): Configure SAML single sign-on and automated user provisioning via Directory Sync (SCIM) to manage your organization's Blaxel access at scale. - [Usage and quotas](https://docs.blaxel.ai/Security/Quotas.md): Monitor account usage in the Blaxel Console, view current quotas for sandboxes, agents, jobs, and other resources, and request quota increases. - [Data collection and privacy](https://docs.blaxel.ai/Security/Data-collection-and-privacy.md): Understand what usage and telemetry data the Blaxel CLI and SDKs collect, how it is used, and how to opt out for privacy-sensitive deployments. - [Policies](https://docs.blaxel.ai/Model-Governance/Policies.md): Define policies that control where workloads run on the Global Agentics Network, including location constraints, flavors, and token limits. - [Regions](https://docs.blaxel.ai/Infrastructure/Regions.md): Available deployment regions for Blaxel infrastructure including Oregon, Virginia, London, and Frankfurt, with guidance on resource-specific region selection. - [Generations](https://docs.blaxel.ai/Infrastructure/Gens.md): Overview of Blaxel infrastructure generations from Mark 1 through Carbon. - [Dedicated egress gateways](https://docs.blaxel.ai/Infrastructure/Dedicated-egress-gateways.md): Attach dedicated egress IP addresses to Blaxel workloads so outbound traffic from sandboxes, agents, and jobs uses predictable, allowlistable IPs. - [Custom domains](https://docs.blaxel.ai/Infrastructure/Custom-domains.md): Expose Blaxel agents, sandboxes, MCP servers, and other resources through your own custom domain names with managed TLS certificates. - [HTTP validation](https://docs.blaxel.ai/Infrastructure/Custom-domains-http-validation.md): Validate the TLS certificate of an application custom domain over HTTP, without publishing a DNS validation record. - [Troubleshoot Blaxel deployments, runtime, and CLI errors](https://docs.blaxel.ai/troubleshooting.md): Resolve common issues with Blaxel deployments including build failures, runtime errors, connectivity problems, and CLI authentication. - [Error codes reference](https://docs.blaxel.ai/troubleshooting/error-codes.md): Reference for structured error codes returned by Blaxel API responses, including the JSON body format and headers designed for LLMs and coding agents. - [Knowledge Base](https://docs.blaxel.ai/knowledge-base/overview.md): Find practical answers, setup guides, security guidance, and troubleshooting help for Blaxel sandboxes and platform workflows. - [Set up Next.js with Blaxel Sandboxes](https://docs.blaxel.ai/knowledge-base/integrations/setting-up-nextjs-with-blaxel-sandboxes.md): Run a Next.js application in a Blaxel Sandbox and expose it securely with a Blaxel preview URL. - [Set up Astro with Blaxel Sandboxes](https://docs.blaxel.ai/knowledge-base/integrations/setting-up-astro-with-blaxel-sandboxes.md): Run an Astro application in a Blaxel Sandbox and expose it securely with a Blaxel preview URL. - [Set up Vite with Blaxel Sandboxes](https://docs.blaxel.ai/knowledge-base/integrations/setting-up-vite-with-blaxel-sandboxes.md): Run a Vite React and TypeScript application in a Blaxel Sandbox and expose it securely with a preview URL. - [Set up Expo with Blaxel Sandboxes](https://docs.blaxel.ai/knowledge-base/integrations/setting-up-expo-with-blaxel-sandboxes.md): Run an Expo React Native and web application in a Blaxel Sandbox and access it through secure preview URLs. - [Using custom domains with sandboxes](https://docs.blaxel.ai/knowledge-base/configuration-and-operation/using-custom-domains-with-sandboxes.md): Configure verified custom domains and wildcard subdomains for Blaxel sandbox preview URLs. - [Getting static IP addresses for Blaxel sandboxes](https://docs.blaxel.ai/knowledge-base/configuration-and-operation/getting-static-ip-addresses-for-blaxel-sandboxes.md): Retrieve the regional public IP address ranges used by Blaxel sandboxes for network allowlists. - [Understanding sandbox active vs standby states and billing](https://docs.blaxel.ai/knowledge-base/configuration-and-operation/understanding-sandbox-active-vs-standby-states-and-billing.md): Understand how active and standby sandbox states affect compute, storage, connections, and billing. - [Understanding sandbox TTL and expiration policies](https://docs.blaxel.ai/knowledge-base/configuration-and-operation/understanding-sandbox-ttl-and-expiration-policies.md): Configure sandbox TTL and expiration policies to control lifecycle, automatic deletion, and storage costs. - [Use template names instead of image IDs when creating sandboxes](https://docs.blaxel.ai/knowledge-base/configuration-and-operation/use-template-names-instead-of-image-id-when-creating-sandboxes.md): Create Blaxel sandboxes from consistent template names instead of workspace-specific image IDs. - [Ensure sandboxes use the latest deployed image](https://docs.blaxel.ai/knowledge-base/configuration-and-operation/ensure-sandboxes-use-the-latest-deployed-image.md): Create or update Blaxel sandboxes with the latest deployed image version and understand how existing sandboxes behave. - [Volume resizing for running sandboxes](https://docs.blaxel.ai/knowledge-base/configuration-and-operation/volume-resizing-for-running-sandboxes.md): Increase attached volume capacity while a Blaxel sandbox is running and automate resizing based on disk usage. - [Sandbox inactivity with long-running processes](https://docs.blaxel.ai/knowledge-base/configuration-and-operation/sandbox-inactivity-with-long-running-processes.md): Keep long-running sandbox processes active by waiting, polling from a backend, or using an external agent architecture. - [Batch delete sandboxes from the CLI](https://docs.blaxel.ai/knowledge-base/configuration-and-operation/batch-delete-sandboxes-from-the-cli.md): Delete all or selected Blaxel sandboxes in bulk with the CLI and jq filters. - [Setting up MCP servers with authentication on Blaxel](https://docs.blaxel.ai/knowledge-base/security-and-authentication/setting-up-mcp-servers-with-authentication-on-blaxel.md): Authenticate connections to Blaxel-hosted MCP servers with API keys or short-lived OAuth tokens. - [Multi-Factor Authentication (MFA) and compliance requirements](https://docs.blaxel.ai/knowledge-base/security-and-authentication/multi-factor-authentication-mfa-and-compliance-requirements.md): Meet MFA and compliance requirements on Blaxel by enforcing MFA through your identity provider and using SAML SSO and Directory Sync. - [How to authenticate the Blaxel CLI in CI environments](https://docs.blaxel.ai/knowledge-base/security-and-authentication/how-to-authenticate-the-bl-cli-in-ci-environments.md): Authenticate the Blaxel CLI with a dedicated API key to automate deployments and other tasks in CI/CD environments. - [Resolving sandbox creation issues](https://docs.blaxel.ai/knowledge-base/troubleshooting/resolving-sandbox-creation-issues.md): Fix Blaxel sandboxes that fail during startup because their custom image has a missing or incorrect entrypoint. - [Resolving sandbox creation race conditions and duplicate requests](https://docs.blaxel.ai/knowledge-base/troubleshooting/resolving-sandbox-creation-race-conditions-and-duplicate-requests.md): Prevent duplicate Blaxel sandbox creation requests and handle 409 conflicts safely with idempotent SDK methods. - [Troubleshooting custom Docker image deployment issues](https://docs.blaxel.ai/knowledge-base/troubleshooting/troubleshooting-custom-docker-image-deployment-issues.md): Diagnose sandbox API, Dockerfile path, build timeout, entrypoint, missing build tools, and logging issues in custom Blaxel sandbox images. - [Sandbox limits and quota exceeded errors](https://docs.blaxel.ai/knowledge-base/troubleshooting/sandbox-limits-and-quota-exceeded-errors.md): Resolve QUOTA_EXCEEDED errors by checking your Blaxel account tier, memory allocation, payment method, and sandbox quota. - [WebSocket connection timeouts and the 15-minute limit](https://docs.blaxel.ai/knowledge-base/troubleshooting/websocket-connection-timeouts-and-15-minute-limit.md): Keep long-running sandbox WebSocket connections reliable by handling the 15-minute idle timeout, reconnection, standby, and ping-pong traffic. - [Handling Preview not found 404 errors in sandboxes](https://docs.blaxel.ai/knowledge-base/troubleshooting/handling-preview-not-found-404-errors-in-sandboxes.md): Resolve Preview not found 404 errors by checking sandbox and preview lifecycle state, TTL settings, and asynchronous deletion races. - [Resolving sandbox restarts caused by nc not found](https://docs.blaxel.ai/knowledge-base/troubleshooting/sandbox-restarting-nc-not-found.md): Stop sandbox restart loops by removing an unnecessary custom entrypoint or installing netcat and using the loopback IP in Debian-based images. - [When localhost goes silent in Debian-based sandboxes](https://docs.blaxel.ai/knowledge-base/troubleshooting/when-localhost-goes-silent-in-debian-based-sandboxes.md): Fix localhost name resolution and service-to-service networking failures after moving sandbox images from Alpine to minimal Debian. - [Fix Miniflare inspector startup failures on Carbon sandboxes](https://docs.blaxel.ai/knowledge-base/troubleshooting/miniflare-inspector-startup-failures-on-carbon.md): Diagnose Astro and Cloudflare preview startup failures caused by older Miniflare versions selecting an unavailable IPv6 localhost address. - [SSL certificate verification errors when cloning repositories](https://docs.blaxel.ai/knowledge-base/troubleshooting/ssl-certificate-verification-errors-when-cloning-repositories.md): Fix Git SSL certificate verification failures in Blaxel sandboxes by installing CA certificates or choosing a base image that includes them. - [Resolving ENOSPC no space left on device errors](https://docs.blaxel.ai/knowledge-base/troubleshooting/resolve-enospc-no-space-left-on-device-errors.md): Resolve ENOSPC storage errors in Blaxel sandboxes by increasing memory allocation or attaching a volume for larger persistent storage. - [Tutorials and examples overview](https://docs.blaxel.ai/Tutorials/Overview.md): Browse Blaxel tutorials and examples covering popular templates, sandbox apps like Next.js and code-server, agent frameworks, and full-repo GitHub templates. - [Self-host Claude Managed Agents on Blaxel](https://docs.blaxel.ai/Tutorials/Claude-Managed-Agents.md): Self-host the Claude Managed Agents (CMA) sandbox execution layer on Blaxel while Anthropic runs the agent loop, with isolated tool execution. - [Run Claude Code in a sandbox](https://docs.blaxel.ai/Tutorials/Claude-Code.md): Run Claude Code inside a Blaxel sandbox to execute coding tasks on a hosted codebase, with persistent storage and secure network access. - [Use Claude Agent SDK with Blaxel](https://docs.blaxel.ai/Tutorials/Claude-Agent-SDK-Index.md): Deploy Claude Agent SDK agents on Blaxel with serverless hosting, colocated close to sandboxes for near-instant latency and full observability. - [Connect Claude Agent SDK to sandboxes](https://docs.blaxel.ai/Tutorials/Claude-Agent-SDK-MCP.md): Connect the Claude Agent SDK (formerly Claude Code SDK) to a Blaxel sandbox to operate processes, files, and code through its built-in MCP server. - [Use Claude Agent SDK with MCP Code Mode](https://docs.blaxel.ai/Tutorials/Claude-Agent-SDK-Code-Mode.md): Connect the Claude Agent SDK to a Blaxel MCP server running in code mode to call any OpenAPI-described API by executing TypeScript in a sandbox. - [Deploy Claude Agent SDK agents on Blaxel](https://docs.blaxel.ai/Tutorials/Claude-Agent-SDK.md): Deploy a Claude Agent SDK agent to Blaxel Agents Hosting as a serverless auto-scalable API, and colocate it close to the sandboxes it works on. - [Run Codex in a sandbox](https://docs.blaxel.ai/Tutorials/Codex.md): Run OpenAI Codex inside a Blaxel sandbox to execute coding tasks on a hosted codebase, with persistent storage and secure network access. - [Give an OpenAI agent a computer and keep its work](https://docs.blaxel.ai/Tutorials/OpenAI-Agents-API.md): Create a report with an OpenAI-hosted agent on Blaxel, inspect the result, and let a fresh session review the saved file through Agent Drive. - [Use OpenAI Agents SDK with sandboxes](https://docs.blaxel.ai/Tutorials/OpenAI-Agents-SDK.md): Use the OpenAI Agents SDK to create compute-capable Codex agents backed by Blaxel sandboxes for running commands, editing files, and executing code. - [Deploy OpenAI Agents SDK on Blaxel](https://docs.blaxel.ai/Tutorials/OpenAI-Agents-SDK-Deployment.md): Deploy an OpenAI Agents SDK agent to Blaxel Agents Hosting as a serverless auto-scalable API and colocate it close to the sandboxes it works on. - [Run Amp in a sandbox](https://docs.blaxel.ai/Tutorials/Amp.md): Run Amp inside a Blaxel sandbox, stream coding tasks, and continue a thread after reconnecting. - [All full repo examples](https://docs.blaxel.ai/Examples/Overview.md): Browse sample agents, MCP servers, and full-repo applications you can use as reference or deploy directly to Blaxel from GitHub templates. - [Sandbox application tutorials overview](https://docs.blaxel.ai/Tutorials/Sandboxes-Overview.md): Browse tutorials for running web applications like Astro, Next.js, Expo, code-server, Docker, and Tailscale inside Blaxel sandboxes. - [Run Astro in a sandbox](https://docs.blaxel.ai/Tutorials/Astro.md): Run an Astro application inside a Blaxel sandbox and expose it securely through preview URLs, with setup steps and end-to-end code examples. - [Run Expo in a sandbox](https://docs.blaxel.ai/Tutorials/Expo.md): Run an Expo (React Native / Web) application inside a Blaxel sandbox and expose it securely through preview URLs with step-by-step setup. - [Run Next.js in a sandbox](https://docs.blaxel.ai/Tutorials/Nextjs.md): Run a Next.js application inside a Blaxel sandbox and expose it securely through preview URLs, with setup steps and end-to-end code examples. - [Run code-server in a sandbox](https://docs.blaxel.ai/Tutorials/Code-server.md): Run VS Code in the browser by deploying code-server inside a Blaxel sandbox, exposed securely through preview URLs for remote development. - [Run Docker in a sandbox](https://docs.blaxel.ai/Tutorials/Docker.md): Build, push, and run Docker images inside a Blaxel sandbox, and expose the running containers securely to the internet through preview URLs. - [Run Tailscale in a sandbox](https://docs.blaxel.ai/Tutorials/Tailscale.md): Connect a Blaxel sandbox to your Tailscale tailnet so you can SSH into it from any authorized device, with step-by-step setup instructions. - [Agent framework tutorials overview](https://docs.blaxel.ai/Tutorials/Agents-Overview.md): Browse framework-specific tutorials for shipping AI agents on Blaxel using LangChain, CrewAI, LlamaIndex, ADK, AI SDK, PydanticAI, and more. - [Run Omnara agents in Blaxel sandboxes](https://docs.blaxel.ai/Tutorials/Omnara.md): Connect your Blaxel workspace to Omnara so agents run commands in Blaxel sandboxes that sleep when idle and wake when the agent needs them. - [Run NVIDIA OpenShell on Blaxel](https://docs.blaxel.ai/Tutorials/OpenShell.md): Deploy NVIDIA OpenShell on Blaxel to run policy-confined agents in isolated microVM sandboxes with audited network access. - [Continue DeepSeek Harness sessions in a Blaxel sandbox](https://docs.blaxel.ai/Tutorials/DeepSeek-Harness.md): Move a DeepSeek Harness session to Blaxel, continue while your laptop is offline, then review and return the conversation and code changes. - [Run coding agents in Blaxel sandboxes from Herdr](https://docs.blaxel.ai/Tutorials/Herdr.md): Use the Herdr Blaxel plugin to run a coding agent in a persistent sandbox, reconnect, preview an application, and apply reviewed changes locally. - [Run OpenClaw on Blaxel](https://docs.blaxel.ai/Tutorials/OpenClaw.md): Deploy and run OpenClaw, an open-source coding agent harness, inside a Blaxel sandbox with persistent volume storage and live preview URLs. - [Run AI SDK on Blaxel](https://docs.blaxel.ai/Tutorials/Vercel-AI.md): Deploy Vercel AI SDK agent projects to Blaxel with minimal code changes to get serverless hosting, agentic observability, and governance policies. - [Use Mastra agents with Blaxel](https://docs.blaxel.ai/Tutorials/Mastra.md): Build Mastra TypeScript agents with built-in support for Blaxel sandboxes, giving your agents secure remote execution environments in the cloud. - [Run LangChain on Blaxel](https://docs.blaxel.ai/Tutorials/LangChain.md): Deploy LangChain and LangGraph projects to Blaxel with minimal code changes to get serverless hosting, agentic observability, and policies. - [Run CrewAI on Blaxel](https://docs.blaxel.ai/Tutorials/CrewAI.md): Deploy multi-agent CrewAI systems on Blaxel with serverless hosting, agentic observability, and connections to MCP servers and external LLM APIs. - [Run Google ADK on Blaxel](https://docs.blaxel.ai/Tutorials/ADK.md): Deploy Google Agent Development Kit (ADK) projects to Blaxel with minimal code changes to get serverless hosting, observability, and policies. - [Run LlamaIndex on Blaxel](https://docs.blaxel.ai/Tutorials/LlamaIndex.md): Deploy LlamaIndex agent and RAG projects to Blaxel with minimal code changes to get serverless hosting, agentic observability, and governance. - [Run PydanticAI on Blaxel](https://docs.blaxel.ai/Tutorials/PydanticAI.md): Deploy PydanticAI agent projects to Blaxel with minimal code changes to get serverless hosting, agentic observability, and governance policies. - [Orchestrate Blaxel agents with n8n](https://docs.blaxel.ai/Tutorials/n8n.md): Build n8n workflows that forward chat messages to Blaxel-hosted AI agents via HTTP requests, with step-by-step setup and configuration. - [Run custom agents on Blaxel](https://docs.blaxel.ai/Tutorials/Custom-Agents.md): Build and deploy fully custom Python or TypeScript agents on Blaxel without using a specific framework, while keeping your code platform-agnostic. - [REST API overview](https://docs.blaxel.ai/api-reference/introduction.md): Authenticate and interact with all Blaxel resources using REST APIs, with support for API key and OAuth 2.0 authentication methods. - [Inference API](https://docs.blaxel.ai/api-reference/inference.md): HTTP reference for the inference endpoints automatically generated when you deploy agents, model APIs, and MCP servers on the Global Agentics Network. - [Billing API endpoint reference](https://docs.blaxel.ai/api-reference/billing.md): HTTP endpoint reference for the Blaxel Billing Explorer API to programmatically retrieve cost, usage, and consumption metrics for your account. - [List all agents](https://docs.blaxel.ai/api-reference/agents/list-all-agents.md): Returns AI agents deployed in the workspace. Each agent includes its deployment status, runtime configuration, and global inference endpoint URL. Starting with API version 2026-04-28 the response is wrapped in `{data, meta}` and supports cursor pagination via the `cursor` and `limit` query parameter… - [Create agent](https://docs.blaxel.ai/api-reference/agents/create-agent.md): Creates a new AI agent deployment from your code. The agent will be built and deployed as a serverless auto-scaling endpoint. Use the Blaxel CLI 'bl deploy' for a simpler deployment experience. - [Get agent](https://docs.blaxel.ai/api-reference/agents/get-agent.md): Returns detailed information about an agent including its current deployment status, configuration, events history, and inference endpoint URL. - [Update agent](https://docs.blaxel.ai/api-reference/agents/update-agent.md): Updates an agent's configuration and triggers a new deployment. Changes to runtime settings, environment variables, or scaling parameters will be applied on the next deployment. - [Delete agent](https://docs.blaxel.ai/api-reference/agents/delete-agent.md): Permanently deletes an agent and all its deployment history. The agent's inference endpoint will immediately stop responding. This action cannot be undone. - [List all agent revisions](https://docs.blaxel.ai/api-reference/agents/list-all-agent-revisions.md) - [List all applications](https://docs.blaxel.ai/api-reference/applications/list-all-applications.md): Returns applications deployed in the workspace. Each application includes its deployment status, runtime configuration, and endpoint URL. Starting with API version 2026-04-28 the response is wrapped in `{data, meta}` and supports cursor pagination via the `cursor` and `limit` query parameters; older… - [Create application](https://docs.blaxel.ai/api-reference/applications/create-application.md): Creates a new application deployment. Applications are long-running workloads that default to public access and mk3 generation. - [Get application](https://docs.blaxel.ai/api-reference/applications/get-application.md): Returns detailed information about an application including its current deployment status, configuration, events history, and endpoint URL. - [Update application](https://docs.blaxel.ai/api-reference/applications/update-application.md): Updates an application's configuration and triggers a new deployment. Changes to runtime settings, environment variables, or scaling parameters will be applied on the next deployment. - [Delete application](https://docs.blaxel.ai/api-reference/applications/delete-application.md): Permanently deletes an application and all its deployment history. The application endpoint will immediately stop responding. This action cannot be undone. - [List all application revisions](https://docs.blaxel.ai/api-reference/applications/list-all-application-revisions.md) - [Create application custom domain](https://docs.blaxel.ai/api-reference/customdomains/create-application-custom-domain.md): Creates a new custom domain scoped to a specific application. After creation, you must configure DNS records and verify domain ownership before it becomes active. - [List custom domains](https://docs.blaxel.ai/api-reference/customdomains/list-custom-domains.md): Returns all custom domains configured in the workspace. Custom domains allow serving preview deployments under your own domain (e.g., preview.yourdomain.com). - [Create custom domain](https://docs.blaxel.ai/api-reference/customdomains/create-custom-domain.md): Creates a new custom domain for preview deployments. After creation, you must configure DNS records and verify domain ownership before it becomes active. - [Get custom domain](https://docs.blaxel.ai/api-reference/customdomains/get-custom-domain.md) - [Update custom domain](https://docs.blaxel.ai/api-reference/customdomains/update-custom-domain.md) - [Delete custom domain](https://docs.blaxel.ai/api-reference/customdomains/delete-custom-domain.md) - [List custom domain shares](https://docs.blaxel.ai/api-reference/customdomains/list-custom-domain-shares.md): Returns the list of workspaces (and/or the account) that a custom domain is currently shared with. - [Share a custom domain](https://docs.blaxel.ai/api-reference/customdomains/share-a-custom-domain.md): Shares a verified custom domain with another workspace of the same account by copying the domain record; the ACM certificate and CloudFront tenant stay with the owner and are reused (not re-provisioned). Use targetWorkspace "account" to make the domain usable by every workspace of the account. Cross… - [Unshare a custom domain](https://docs.blaxel.ai/api-reference/customdomains/unshare-a-custom-domain.md): Revokes sharing of a custom domain with a target workspace (or the account when targetWorkspace is "account"). Removes the shared copy / clears the account-global marker; the owner's domain is not affected. - [Verify custom domain](https://docs.blaxel.ai/api-reference/customdomains/verify-custom-domain.md) - [Get latest changelog entries](https://docs.blaxel.ai/api-reference/changelog/get-latest-changelog-entries.md): Returns the latest public changelog entries for the controlplane UI. The origin response is intentionally not cached in memory; CloudFront caches this endpoint according to the Cache-Control header. - [Get platform configuration](https://docs.blaxel.ai/api-reference/configurations/get-platform-configuration.md): Returns global platform configuration including available regions, countries, continents, and private locations for deployment policies. - [List drives](https://docs.blaxel.ai/api-reference/drives/list-drives.md): Returns all drives in the workspace. Drives provide persistent storage that can be attached to agents, functions, and sandboxes. Starting with API version 2026-04-28, the response wraps items in `{data, meta}` and supports cursor pagination via the `cursor` and `limit` query parameters; older versio… - [Create a drive](https://docs.blaxel.ai/api-reference/drives/create-a-drive.md): Creates a new drive in the workspace. Drives can be buckets and can be mounted at runtime to sandboxes. - [Get a drive](https://docs.blaxel.ai/api-reference/drives/get-a-drive.md): Retrieves details of a specific drive including its status and events. - [Update a drive](https://docs.blaxel.ai/api-reference/drives/update-a-drive.md): Updates an existing drive. Metadata fields like displayName and labels can be changed. Size can be set if not already configured. - [Delete a drive](https://docs.blaxel.ai/api-reference/drives/delete-a-drive.md): Starts the deletion of a drive. The drive is marked DELETING and its storage is wiped asynchronously; the drive disappears from listings once the cleanup completes. - [Create drive access token](https://docs.blaxel.ai/api-reference/drives/create-drive-access-token.md): Issues a short-lived JWT access token scoped to a specific drive. The token can be used as Bearer authentication for direct S3 operations against the drive's bucket. - [Delete a folder and its contents](https://docs.blaxel.ai/api-reference/drives/delete-a-folder-and-its-contents.md): Deletes a folder and all its contents directly in drive storage. This is synchronous and non-atomic. If it times out or fails, some contents may have been deleted; retry the same path to finish cleanup. An absent folder succeeds. The drive root and internal metadata cannot be deleted. - [Get drive by external ID](https://docs.blaxel.ai/api-reference/drives/get-drive-by-external-id.md): Returns a drive matching the given external ID. If no drive is found, returns 404. - [Get drive token JWKS](https://docs.blaxel.ai/api-reference/drives/get-drive-token-jwks.md): Returns the JSON Web Key Set containing the Ed25519 public key used to verify drive access tokens. Other S3-compatible storage can use this endpoint to validate Bearer tokens. - [List all egress gateways across all VPCs in the workspace](https://docs.blaxel.ai/api-reference/vpcs/list-all-egress-gateways-across-all-vpcs-in-the-workspace.md) - [Egress gateway sandbox attachments](https://docs.blaxel.ai/api-reference/vpcs/egress-gateway-sandbox-attachments.md): Returns the inverse map (gateway → sandbox names) for the workspace. Used by the egress-IPs UI to render attachment counts without fetching the sandboxes listing full client-side. - [List all egress IPs across all VPCs and gateways in the workspace](https://docs.blaxel.ai/api-reference/vpcs/list-all-egress-ips-across-all-vpcs-and-gateways-in-the-workspace.md) - [List all VPCs in the workspace](https://docs.blaxel.ai/api-reference/vpcs/list-all-vpcs-in-the-workspace.md) - [Create a VPC for the workspace](https://docs.blaxel.ai/api-reference/vpcs/create-a-vpc-for-the-workspace.md) - [Get a VPC by name](https://docs.blaxel.ai/api-reference/vpcs/get-a-vpc-by-name.md) - [Delete a VPC](https://docs.blaxel.ai/api-reference/vpcs/delete-a-vpc.md) - [List egress gateways in a VPC](https://docs.blaxel.ai/api-reference/vpcs/list-egress-gateways-in-a-vpc.md) - [Create an egress gateway in a VPC](https://docs.blaxel.ai/api-reference/vpcs/create-an-egress-gateway-in-a-vpc.md) - [Get an egress gateway by name](https://docs.blaxel.ai/api-reference/vpcs/get-an-egress-gateway-by-name.md) - [Delete an egress gateway](https://docs.blaxel.ai/api-reference/vpcs/delete-an-egress-gateway.md) - [List egress IPs in a gateway](https://docs.blaxel.ai/api-reference/vpcs/list-egress-ips-in-a-gateway.md) - [Allocate a new egress IP from the gateway](https://docs.blaxel.ai/api-reference/vpcs/allocate-a-new-egress-ip-from-the-gateway.md) - [Get an egress IP by name](https://docs.blaxel.ai/api-reference/vpcs/get-an-egress-ip-by-name.md) - [Delete an egress IP](https://docs.blaxel.ai/api-reference/vpcs/delete-an-egress-ip.md) - [Get enabled features for workspace](https://docs.blaxel.ai/api-reference/workspaces/get-enabled-features-for-workspace.md): Returns only the feature flags that are currently enabled for the specified workspace. Disabled features are not included to prevent information leakage. - [List workspace team members](https://docs.blaxel.ai/api-reference/workspaces/list-workspace-team-members.md): Returns all team members in the workspace including their roles (admin, member or viewer) and invitation status. - [Invite user to workspace](https://docs.blaxel.ai/api-reference/workspaces/invite-user-to-workspace.md): Invites a new team member to the workspace by email. The invitee will receive an email to accept the invitation before gaining access to workspace resources. - [Update user role in workspace](https://docs.blaxel.ai/api-reference/workspaces/update-user-role-in-workspace.md): Updates the role of a user in the workspace. - [Remove user from workspace or revoke invitation](https://docs.blaxel.ai/api-reference/workspaces/remove-user-from-workspace-or-revoke-invitation.md): Removes a user from the workspace (or revokes an invitation if the user has not accepted the invitation yet). - [List accessible workspaces](https://docs.blaxel.ai/api-reference/workspaces/list-accessible-workspaces.md): Returns all workspaces the authenticated user has access to. Each workspace is a separate tenant with its own resources, team members, and billing. - [Create workspace tenant](https://docs.blaxel.ai/api-reference/workspaces/create-workspace-tenant.md): Creates a new workspace tenant. The authenticated user becomes the workspace admin. Requires a linked billing account. - [Get workspace details](https://docs.blaxel.ai/api-reference/workspaces/get-workspace-details.md): Returns detailed information about a workspace including its display name, account ID, status, and runtime configuration. - [Update workspace](https://docs.blaxel.ai/api-reference/workspaces/update-workspace.md): Updates a workspace's settings such as display name and labels. The workspace name cannot be changed after creation. - [Delete workspace tenant](https://docs.blaxel.ai/api-reference/workspaces/delete-workspace-tenant.md): Permanently deletes a workspace and ALL its resources (agents, functions, sandboxes, volumes, etc.). This action cannot be undone. Only workspace admins can delete a workspace. - [Leave workspace](https://docs.blaxel.ai/api-reference/workspaces/leave-workspace.md): Leaves a workspace. - [Check workspace availability](https://docs.blaxel.ai/api-reference/workspaces/check-workspace-availability.md): Check if a workspace is available. - [Retrieve feature flag evaluation for workspace](https://docs.blaxel.ai/api-reference/featureflags/retrieve-feature-flag-evaluation-for-workspace.md): Evaluates a specific feature flag for the workspace with full details including variant and payload. Useful for testing and debugging feature flag targeting. - [List all MCP servers](https://docs.blaxel.ai/api-reference/functions/list-all-mcp-servers.md): Returns MCP server functions deployed in the workspace. Each function includes its deployment status, transport protocol (websocket or http-stream), and endpoint URL. Starting with API version 2026-04-28 the response is wrapped in `{data, meta}` and supports cursor pagination via the `cursor` and `l… - [Create MCP server](https://docs.blaxel.ai/api-reference/functions/create-mcp-server.md): Creates a new MCP server function deployment. The function will expose tools via the Model Context Protocol that can be used by AI agents. Supports streamable HTTP transport. - [Get MCP server](https://docs.blaxel.ai/api-reference/functions/get-mcp-server.md): Returns detailed information about an MCP server function including its deployment status, available tools, transport configuration, and endpoint URL. - [Update MCP server](https://docs.blaxel.ai/api-reference/functions/update-mcp-server.md): Updates an MCP server function's configuration and triggers a new deployment. Changes to runtime settings, integrations, or transport protocol will be applied on the next deployment. - [Delete MCP server](https://docs.blaxel.ai/api-reference/functions/delete-mcp-server.md): Permanently deletes an MCP server function and all its deployment history. Any agents using this function's tools will no longer be able to invoke them. - [List function revisions](https://docs.blaxel.ai/api-reference/functions/list-function-revisions.md): Returns revisions for a function by name. - [List container images](https://docs.blaxel.ai/api-reference/images/list-container-images.md): Returns paginated image summaries starting with API version 2026-09-22. Older versions return a bare array including all tags. - [Build a container image](https://docs.blaxel.ai/api-reference/images/build-a-container-image.md): Builds or imports a container image without creating a deployment. Provide a registry image reference to download and convert an existing image, or omit image to receive a presigned URL for uploading source code. Registry imports can specify memoryMb and volumeMb for the import worker. These setting… - [Cleanup unused container images](https://docs.blaxel.ai/api-reference/images/cleanup-unused-container-images.md): Cleans up unused container images in the workspace registry. Only removes images that are not currently referenced by any active agent, function, sandbox, or job deployment. One call runs for a limited time; when hasMore is true, only part of the unused images were deleted and the call should be rep… - [Get container image](https://docs.blaxel.ai/api-reference/images/get-container-image.md): Returns a bounded image summary starting with API version 2026-09-22. Older versions return the image with all tags. - [Delete container image](https://docs.blaxel.ai/api-reference/images/delete-container-image.md): Deletes a container image and all its tags from the workspace registry. Will fail if the image is currently in use by an active deployment. - [Cancel container image builds in progress](https://docs.blaxel.ai/api-reference/images/cancel-container-image-builds-in-progress.md): Ends every build of this image that is queued or running on the build queue, whether it waits for capacity or runs in its build environment. Each cancelled build is filed as failed with the message "The build was cancelled.", releases its build quota and its tag reservation, and a build that was wai… - [List image shares](https://docs.blaxel.ai/api-reference/images/list-image-shares.md): Returns the list of workspaces that a container image is currently shared with. - [Share a container image](https://docs.blaxel.ai/api-reference/images/share-a-container-image.md): Shares a container image with another workspace by copying the metadata record. The underlying storage (S3) data is not duplicated. For same-account targets the share is applied immediately. For cross-account targets, a pending image share is created and must be explicitly accepted by an admin of th… - [Unshare a container image](https://docs.blaxel.ai/api-reference/images/unshare-a-container-image.md): Revokes sharing of a container image with a target workspace. Removes the metadata copy from the target workspace. The source image is not affected. - [List image tags](https://docs.blaxel.ai/api-reference/images/list-image-tags.md): Returns a bounded page of image tags. Search by prefix or exact name. Tags are ordered by name only. Send Blaxel-Version 2026-09-22 with image catalog requests. - [Delete container image tag](https://docs.blaxel.ai/api-reference/images/delete-container-image-tag.md): Deletes a specific tag from a container image. The underlying image layers are kept if other tags reference them. Will fail if the tag is currently in use. - [List pending image shares](https://docs.blaxel.ai/api-reference/images/list-pending-image-shares.md): Lists pending cross-account image shares targeting the caller's workspace (incoming) or originating from it (outgoing). Expired shares are cleaned up opportunistically. - [Accept a pending image share](https://docs.blaxel.ai/api-reference/images/accept-a-pending-image-share.md): Accepts a pending cross-account image share and copies the image metadata to the target workspace. Caller must be an admin of the target workspace. - [Decline a pending image share](https://docs.blaxel.ai/api-reference/images/decline-a-pending-image-share.md): Declines a pending cross-account image share. Caller must be an admin of the target workspace. - [Get integration provider info](https://docs.blaxel.ai/api-reference/integrations/get-integration-provider-info.md): Returns metadata about an integration provider including available endpoints, authentication methods, and supported models or features. - [List integration connections](https://docs.blaxel.ai/api-reference/integrations/list-integration-connections.md): Returns all configured integration connections in the workspace. Each connection stores credentials and settings for an external service (LLM provider, API, database). - [Create integration connection](https://docs.blaxel.ai/api-reference/integrations/create-integration-connection.md): Creates a new integration connection with credentials for an external service. The connection can then be used by models, functions, and other resources to authenticate with the service. - [Get integration connection](https://docs.blaxel.ai/api-reference/integrations/get-integration-connection.md): Returns detailed information about an integration connection including its provider type, configuration (secrets are masked), and usage status. - [Update integration connection](https://docs.blaxel.ai/api-reference/integrations/update-integration-connection.md): Updates an integration connection's configuration or credentials. Changes take effect immediately for all resources using this connection. - [Delete integration connection](https://docs.blaxel.ai/api-reference/integrations/delete-integration-connection.md): Permanently deletes an integration connection. Any resources using this connection will lose access to the external service. - [Get integration connection model endpoint configurations](https://docs.blaxel.ai/api-reference/integrations/get-integration-connection-model-endpoint-configurations.md): Returns a list of all endpoint configurations for a model. - [List integration connection models](https://docs.blaxel.ai/api-reference/integrations/list-integration-connection-models.md): Returns a list of all models for an integration connection. - [Get integration connection model](https://docs.blaxel.ai/api-reference/integrations/get-integration-connection-model.md): Returns a model for an integration connection by ID. - [List batch jobs](https://docs.blaxel.ai/api-reference/jobs/list-batch-jobs.md): Returns batch job definitions in the workspace. Each job can be triggered to run multiple parallel tasks with configurable concurrency and retry settings. Starting with API version 2026-04-28 the response is wrapped in `{data, meta}` and supports cursor pagination via the `cursor` and `limit` query… - [Create batch job](https://docs.blaxel.ai/api-reference/jobs/create-batch-job.md): Creates a new batch job definition for parallel AI task processing. Jobs can be triggered via API or scheduled, and support configurable parallelism, timeouts, and retry logic. - [Get batch job](https://docs.blaxel.ai/api-reference/jobs/get-batch-job.md): Returns detailed information about a batch job including its runtime configuration, execution history, and deployment status. - [Update batch job](https://docs.blaxel.ai/api-reference/jobs/update-batch-job.md): Updates a batch job's configuration. Changes affect new executions; running executions continue with their original configuration. - [Delete batch job](https://docs.blaxel.ai/api-reference/jobs/delete-batch-job.md): Permanently deletes a batch job definition and cancels any running executions. Historical execution data will be retained for a limited time. - [List job executions](https://docs.blaxel.ai/api-reference/jobs/list-job-executions.md): Returns executions for a batch job. Starting with API version 2026-04-28 the response is wrapped in `{data, meta}` and supports cursor pagination via the `cursor` and `limit` query parameters; older versions keep the legacy offset/limit contract and return a bare array. - [Create job execution](https://docs.blaxel.ai/api-reference/jobs/create-job-execution.md): Triggers a new execution of the batch job. Each execution runs multiple tasks in parallel according to the job's configured concurrency. Tasks can be parameterized via the request body. - [Get job execution](https://docs.blaxel.ai/api-reference/jobs/get-job-execution.md): Returns detailed information about a specific job execution including status, task statistics (success/failure/running counts), and timing information. - [Cancel job execution](https://docs.blaxel.ai/api-reference/jobs/cancel-job-execution.md): Cancels a running job execution. Tasks already in progress will complete, but no new tasks will be started. The execution status changes to 'cancelling' then 'cancelled'. - [List execution tasks](https://docs.blaxel.ai/api-reference/jobs/list-execution-tasks.md): Returns one cursor-paginated page of an execution's tasks. Tasks are derived from event history each request; only the in-memory slicing is paginated, the events scan still fetches the whole event log behind the scenes. Available starting with API version 2026-04-28. - [List job revisions](https://docs.blaxel.ai/api-reference/jobs/list-job-revisions.md): Returns revisions for a job by name. - [List deployment regions](https://docs.blaxel.ai/api-reference/locations/list-deployment-regions.md): Returns all deployment regions with their current availability status and supported hardware flavors. Use this to discover where resources can be deployed. - [List MCP Hub servers](https://docs.blaxel.ai/api-reference/mcphub/list-mcp-hub-servers.md): Returns all pre-built MCP server definitions available in the Blaxel Hub. These can be deployed directly to your workspace with pre-configured tools and integrations. - [List model endpoints](https://docs.blaxel.ai/api-reference/models/list-model-endpoints.md): Returns model gateway endpoints configured in the workspace. Each model represents a proxy to an external LLM provider (OpenAI, Anthropic, etc.) with unified access control. Starting with API version 2026-04-28 the response is wrapped in `{data, meta}` and supports cursor pagination via the `cursor`… - [Create model endpoint](https://docs.blaxel.ai/api-reference/models/create-model-endpoint.md): Creates a new model gateway endpoint that proxies requests to an external LLM provider. Requires an integration connection with valid API credentials for the target provider. - [Get model endpoint](https://docs.blaxel.ai/api-reference/models/get-model-endpoint.md): Returns detailed information about a model gateway endpoint including its provider configuration, integration connection, and usage status. - [Update model endpoint](https://docs.blaxel.ai/api-reference/models/update-model-endpoint.md): Updates a model gateway endpoint's configuration. Changes to provider settings or integration connection take effect immediately. - [Delete model endpoint](https://docs.blaxel.ai/api-reference/models/delete-model-endpoint.md): Permanently deletes a model gateway endpoint. Any agents or applications using this endpoint will need to be updated to use a different model. - [List model revisions](https://docs.blaxel.ai/api-reference/models/list-model-revisions.md): Returns revisions for a model by name. - [List governance policies](https://docs.blaxel.ai/api-reference/policies/list-governance-policies.md): Returns governance policies in the workspace. Policies control deployment locations, hardware flavors, and token limits for agents, functions, and models. Starting with API version 2026-04-28 the response is wrapped in `{data, meta}` and supports cursor pagination via the `cursor` and `limit` query… - [Create governance policy](https://docs.blaxel.ai/api-reference/policies/create-governance-policy.md): Creates a new governance policy to control where and how resources are deployed. Policies can restrict deployment to specific regions, countries, or continents for compliance. - [Get governance policy](https://docs.blaxel.ai/api-reference/policies/get-governance-policy.md): Returns detailed information about a governance policy including its type (location, flavor, or maxToken), restrictions, and which resource types it applies to. - [Update governance policy](https://docs.blaxel.ai/api-reference/policies/update-governance-policy.md): Updates a governance policy's restrictions. Changes take effect on the next deployment of resources using this policy. - [Delete governance policy](https://docs.blaxel.ai/api-reference/policies/delete-governance-policy.md): Permanently deletes a governance policy. Resources using this policy will need to be updated to use a different policy. - [List resources using a policy](https://docs.blaxel.ai/api-reference/policies/list-resources-using-a-policy.md): Returns the names of every resource (agent, function, model, sandbox, job) currently referencing the given policy. Replaces the client-side fan-out the policies UI used to do over the listings. - [List public ips](https://docs.blaxel.ai/api-reference/publicips:list/list-public-ips.md): Returns a list of all public ips used in Blaxel.. - [List Sandbox Hub templates](https://docs.blaxel.ai/api-reference/sandboxhub/list-sandbox-hub-templates.md): Returns all pre-built sandbox templates available in the Blaxel Hub. These include popular development environments with pre-installed tools and frameworks. - [List sandboxes](https://docs.blaxel.ai/api-reference/compute/list-sandboxes.md): Returns sandboxes in the workspace. Each sandbox includes its configuration, status, and endpoint URL. Terminated sandboxes are hidden by default; pass `showTerminated=true` to include them. Starting with API version 2026-04-28 the response is wrapped in `{data, meta}` and supports cursor pagination… - [Create sandbox](https://docs.blaxel.ai/api-reference/compute/create-sandbox.md): Creates a new sandbox VM for secure AI code execution. Sandboxes automatically scale to zero when idle and resume instantly, preserving memory state including running processes and filesystem. - [Get sandbox](https://docs.blaxel.ai/api-reference/compute/get-sandbox.md): Returns detailed information about a sandbox including its configuration, attached volumes, lifecycle policies, and API endpoint URL. - [Update sandbox](https://docs.blaxel.ai/api-reference/compute/update-sandbox.md): Updates a sandbox's configuration. Note that certain changes (like image or memory) may reset the sandbox state. Use lifecycle policies to control automatic cleanup. - [Delete sandbox](https://docs.blaxel.ai/api-reference/compute/delete-sandbox.md): Permanently deletes a sandbox and all its data. If no volumes are attached, this guarantees zero data retention (ZDR). This action cannot be undone. - [Archive sandbox](https://docs.blaxel.ai/api-reference/compute/archive-sandbox.md): Archives a sandbox. The changes its filesystem accumulated over its image are exported to the archive store, then the sandbox is shut down while its definition is kept, so it can be recreated later with the same disk. Memory and running processes are not preserved, processes are started again from t… - [Fork sandbox](https://docs.blaxel.ai/api-reference/compute/fork-sandbox.md): Forks a sandbox into a new sandbox or application. When forking to a sandbox, the target must not already exist (409 if it does). When forking to an application, a new revision is added if the app already exists, or a new application is created. With no snapshotId, a fork to a sandbox copies the sou… - [List Sandbox Previews](https://docs.blaxel.ai/api-reference/compute/list-sandbox-previews.md): Returns a list of Sandbox Previews in the workspace. - [Create Sandbox Preview](https://docs.blaxel.ai/api-reference/compute/create-sandbox-preview.md): Create a preview - [Get Sandbox Preview](https://docs.blaxel.ai/api-reference/compute/get-sandbox-preview.md): Returns a Sandbox Preview by name. - [Update Sandbox Preview](https://docs.blaxel.ai/api-reference/compute/update-sandbox-preview.md): Updates a Sandbox Preview by name. - [Delete Sandbox Preview](https://docs.blaxel.ai/api-reference/compute/delete-sandbox-preview.md): Deletes a Sandbox Preview by name. - [Get tokens for Sandbox Preview](https://docs.blaxel.ai/api-reference/compute/get-tokens-for-sandbox-preview.md): Gets tokens for a Sandbox Preview. - [Create token for Sandbox Preview](https://docs.blaxel.ai/api-reference/compute/create-token-for-sandbox-preview.md): Creates a token for a Sandbox Preview. - [Delete token for Sandbox Preview](https://docs.blaxel.ai/api-reference/compute/delete-token-for-sandbox-preview.md): Deletes a token for a Sandbox Preview by name. - [List Sandbox Schedule Executions](https://docs.blaxel.ai/api-reference/compute/list-sandbox-schedule-executions.md): Returns the execution history of a Sandbox's schedules (across all schedules of the sandbox), newest first. Cursor-paginated via the `cursor` and `limit` query parameters. Each item records the HTTP status of submitting the scheduled command and the process name for log lookup. - [List Sandbox Schedules](https://docs.blaxel.ai/api-reference/compute/list-sandbox-schedules.md): Returns the schedules configured on a Sandbox. Starting with API version 2026-04-28 the response is wrapped in `{data, meta}` and supports cursor pagination via the `cursor` and `limit` query parameters; older versions return a bare array. - [Create Sandbox Schedule](https://docs.blaxel.ai/api-reference/compute/create-sandbox-schedule.md): Adds a schedule to a Sandbox. - [Get Sandbox Schedule](https://docs.blaxel.ai/api-reference/compute/get-sandbox-schedule.md): Returns a Sandbox Schedule by id. - [Update Sandbox Schedule](https://docs.blaxel.ai/api-reference/compute/update-sandbox-schedule.md): Updates a Sandbox Schedule by id. - [Delete Sandbox Schedule](https://docs.blaxel.ai/api-reference/compute/delete-sandbox-schedule.md): Deletes a Sandbox Schedule by id. - [List sandbox snapshots](https://docs.blaxel.ai/api-reference/compute/list-sandbox-snapshots.md): Returns a list of snapshots for the specified sandbox. - [Create sandbox snapshot](https://docs.blaxel.ai/api-reference/compute/create-sandbox-snapshot.md): Creates a point-in-time snapshot of a sandbox. Snapshots capture the sandbox state and can be used for forking into new sandboxes or applications. This is a WIP endpoint — the full implementation depends on the execution plane. - [Delete sandbox snapshot](https://docs.blaxel.ai/api-reference/compute/delete-sandbox-snapshot.md): Deletes a snapshot of a sandbox, addressed by its name among that sandbox's snapshots (or by its ID). - [Restore sandbox from snapshot](https://docs.blaxel.ai/api-reference/compute/restore-sandbox-from-snapshot.md): Restores a sandbox to one of its own snapshots. The running sandbox is torn down and rebuilt from the snapshot under the same name and URLs, so everything it held since the snapshot was taken is lost unless it was itself snapshotted. - [Unarchive sandbox](https://docs.blaxel.ai/api-reference/compute/unarchive-sandbox.md): Recreates an archived sandbox from its archive. The recreated sandbox runs the current generation whatever generation it was archived from, restores the archived filesystem before anything starts, and starts the saved processes again with new process identifiers. - [Get sandbox by external ID](https://docs.blaxel.ai/api-reference/compute/get-sandbox-by-external-id.md): Returns the most recent non-terminated sandbox matching the given external ID. If no active sandbox is found, returns 404. - [List Workspace Schedule Executions](https://docs.blaxel.ai/api-reference/compute/list-workspace-schedule-executions.md): Returns schedule execution submissions across the workspace, newest first by default. Status describes submission acceptance, not process completion. since and until are inclusive RFC 3339 bounds on creation time. - [List Workspace Schedules](https://docs.blaxel.ai/api-reference/compute/list-workspace-schedules.md): Returns schedule definitions across the workspace, newest first by default. - [Get Sandbox Scheduling Metrics](https://docs.blaxel.ai/api-reference/compute/get-sandbox-scheduling-metrics.md): Returns active sandbox and scheduling metrics for a UTC minute window. since is inclusive and until is exclusive. The default window is the last 24 hours and the maximum is 7 days. Execution status describes submission acceptance, not process completion. Execution totals begin accumulating when metr… - [List snapshots](https://docs.blaxel.ai/api-reference/compute/list-snapshots.md): Returns the snapshots of the workspace, newest first by default, including the ones whose source object has been deleted. Starting with API version 2026-04-28 the response is wrapped in `{data, meta}` and supports cursor pagination via the `cursor` and `limit` query parameters; older versions keep r… - [Create snapshot](https://docs.blaxel.ai/api-reference/compute/create-snapshot.md): Captures a snapshot from a source object. The snapshot belongs to the workspace rather than to its source, so it survives the deletion of the object it was captured from, and carries what creating a sandbox or an application from it needs. - [Get snapshot](https://docs.blaxel.ai/api-reference/compute/get-snapshot.md): Returns a snapshot of the workspace by ID. - [Delete snapshot](https://docs.blaxel.ai/api-reference/compute/delete-snapshot.md): Deletes a snapshot. There is a single snapshot object, so this removes it for the whole workspace, whether or not the object it was captured from still exists. - [Fork snapshot](https://docs.blaxel.ai/api-reference/compute/fork-snapshot.md): Creates a new sandbox or application from a snapshot. The snapshot is enough on its own, so this works after the object it was captured from has been deleted. - [List secrets](https://docs.blaxel.ai/api-reference/secrets/list-secrets.md): Lists the secrets of the workspace. Values are write-only and never returned. - [Upsert secret](https://docs.blaxel.ai/api-reference/secrets/upsert-secret.md): Creates or updates a secret by name. Each call stores a new immutable version; the latest version is the one resolved by the proxy. - [Delete secret by query](https://docs.blaxel.ai/api-reference/secrets/delete-secret-by-query.md): Deletes a secret by name (query parameter) from the workspace. - [Delete secret](https://docs.blaxel.ai/api-reference/secrets/delete-secret.md): Deletes a secret and all its versions from the workspace. - [List service accounts](https://docs.blaxel.ai/api-reference/service_accounts/list-service-accounts.md): Returns all service accounts in the workspace. Service accounts are machine identities for external systems to authenticate with Blaxel via OAuth or API keys. - [Create service account](https://docs.blaxel.ai/api-reference/service_accounts/create-service-account.md): Creates a new service account for machine-to-machine authentication. Returns client ID and secret (secret is only shown once at creation). Use these credentials for OAuth client_credentials flow. - [Update service account](https://docs.blaxel.ai/api-reference/service_accounts/update-service-account.md): Updates a service account's name or description. Credentials (client ID/secret) cannot be changed. - [Delete service account](https://docs.blaxel.ai/api-reference/service_accounts/delete-service-account.md): Permanently deletes a service account and invalidates all its credentials. Any systems using this service account will lose access immediately. - [List service account API keys](https://docs.blaxel.ai/api-reference/service_accounts/list-service-account-api-keys.md): Returns all long-lived API keys created for a service account. API keys provide an alternative to OAuth for simpler authentication scenarios. - [Create service account API key](https://docs.blaxel.ai/api-reference/service_accounts/create-service-account-api-key.md): Creates a new long-lived API key for a service account. The full key value is only returned once at creation. API keys can have optional expiration dates. - [Revoke service account API key](https://docs.blaxel.ai/api-reference/service_accounts/revoke-service-account-api-key.md): Revokes an API key for a service account. The key becomes invalid immediately and any requests using it will fail authentication. - [List deployment templates](https://docs.blaxel.ai/api-reference/templates/list-deployment-templates.md): Returns all deployment templates available for creating agents, functions, and other resources with pre-configured settings and code. - [Get template](https://docs.blaxel.ai/api-reference/templates/get-template.md): Returns detailed information about a deployment template including its configuration, source code reference, and available parameters. - [List volume templates](https://docs.blaxel.ai/api-reference/volumetemplates/list-volume-templates.md): Returns all volume templates in the workspace. Volume templates contain pre-configured filesystem snapshots that can be used to initialize new volumes. - [Create volume template](https://docs.blaxel.ai/api-reference/volumetemplates/create-volume-template.md): Creates a new volume template for initializing volumes with pre-configured filesystem contents. Optionally returns a presigned URL for uploading the template archive. - [Get volume template](https://docs.blaxel.ai/api-reference/volumetemplates/get-volume-template.md): Returns a volume template by name. - [Create or update volume template](https://docs.blaxel.ai/api-reference/volumetemplates/create-or-update-volume-template.md): Creates or updates a volume template. - [Delete volume template](https://docs.blaxel.ai/api-reference/volumetemplates/delete-volume-template.md): Deletes a volume template by name. - [Delete volume template version](https://docs.blaxel.ai/api-reference/volumetemplates/delete-volume-template-version.md): Deletes a specific version of a volume template. - [List persistent volumes](https://docs.blaxel.ai/api-reference/volumes/list-persistent-volumes.md): Returns persistent storage volumes in the workspace. Volumes can be attached to sandboxes for durable file storage that persists across sessions and sandbox deletions. Starting with API version 2026-04-28 the response is wrapped in `{data, meta}` and supports cursor pagination via the `cursor` and `… - [Create persistent volume](https://docs.blaxel.ai/api-reference/volumes/create-persistent-volume.md): Creates a new persistent storage volume that can be attached to sandboxes. Volumes must be created in a specific region and can only attach to sandboxes in the same region. - [Get persistent volume](https://docs.blaxel.ai/api-reference/volumes/get-persistent-volume.md): Returns detailed information about a volume including its size, region, attachment status, and any events history. - [Update volume](https://docs.blaxel.ai/api-reference/volumes/update-volume.md): Updates a volume. - [Delete persistent volume](https://docs.blaxel.ai/api-reference/volumes/delete-persistent-volume.md): Permanently deletes a volume and all its data. The volume must not be attached to any sandbox. This action cannot be undone. - [Get volume by external ID](https://docs.blaxel.ai/api-reference/volumes/get-volume-by-external-id.md): Returns an active volume matching the given external ID. If no active volume is found, returns 404. - [Export the filesystem changes to a presigned URL](https://docs.blaxel.ai/api-reference/archive/export-the-filesystem-changes-to-a-presigned-url.md): Archives everything the sandbox changed on top of its base image and streams it, uncompressed, to a presigned S3 PUT URL. The memory of the sandbox is not archived. The sandbox is quiesced first: the process list is saved (unless saveProcesses is false), every process is stopped, and the API then re… - [Lift the archive freeze](https://docs.blaxel.ai/api-reference/archive/lift-the-archive-freeze.md): Makes the API serve every route again after an export. The processes stopped for the export are not relaunched: this exists so a failed or aborted export does not leave the sandbox unusable. - [Get the archive status](https://docs.blaxel.ai/api-reference/archive/get-the-archive-status.md): Reports whether the sandbox is frozen for an archive export, and which processes were stopped for it. - [Apply code edit](https://docs.blaxel.ai/api-reference/fastapply/apply-code-edit.md): Uses the configured LLM provider (Relace or Morph) to apply a code edit to the original content. - [Code reranking/semantic search](https://docs.blaxel.ai/api-reference/codegen/code-rerankingsemantic-search.md): Deprecated: Relace and Morph discontinued their reranking APIs, so this endpoint no longer returns results (503 when a codegen provider is configured). - [List currently mounted drives](https://docs.blaxel.ai/api-reference/drive/list-currently-mounted-drives.md): Returns a list of all currently mounted drives managed by blfs - [Attach a drive to a local path](https://docs.blaxel.ai/api-reference/drive/attach-a-drive-to-a-local-path.md): Mounts an agent drive using the blfs binary to a local path, optionally mounting a subpath within the drive. Supports optional UID/GID mapping to remap file ownership between the local sandbox and the filer (always mapped to filer UID/GID 0). Mapping values can be set per-request via uidMap/gidMap f… - [Detach a drive from a local path](https://docs.blaxel.ai/api-reference/drive/detach-a-drive-from-a-local-path.md): Unmounts a previously mounted drive from the specified local path - [Reload environment from guest metadata](https://docs.blaxel.ai/api-reference/system/reload-environment-from-guest-metadata.md): Re-reads /bl/metadata and applies its environment to the sandbox-api process, so this process and every process started afterwards see the current values. Called by the guest init after an environment update; safe to call manually. - [Health check](https://docs.blaxel.ai/api-reference/system/health-check.md): Returns health status and system information including upgrade count and binary details Also includes last upgrade attempt status with detailed error information if available - [Resume the sandbox](https://docs.blaxel.ai/api-reference/system/resume-the-sandbox.md): Wakes a sandbox in standby: like any request, it resumes the sandbox before it is answered. Answers right away when the sandbox is already running. - [Put the sandbox in standby](https://docs.blaxel.ai/api-reference/system/put-the-sandbox-in-standby.md): Asks the host to put the sandbox in standby right away instead of waiting for it to be idle. Returns 202 before the standby happens; the connection is closed and the sandbox pauses shortly after. Refused while a keepAlive process or an archive operation holds the sandbox awake, unless force is true.… - [Upgrade the sandbox-api](https://docs.blaxel.ai/api-reference/system/upgrade-the-sandbox-api.md): Triggers an upgrade of the sandbox-api process. Returns 200 immediately before upgrading. The upgrade will: download the specified binary from GitHub releases, validate it, and restart. All running processes will be preserved across the upgrade. Available versions: "latest" (default, most recent rel… - [Search for text content in files](https://docs.blaxel.ai/api-reference/filesystem/search-for-text-content-in-files.md): Searches for text content inside files. Returns each matching line, with the lines around it when contextLines is set. - [Copy a file or directory](https://docs.blaxel.ai/api-reference/filesystem/copy-a-file-or-directory.md): Recursively copy a file or directory in one request, placed like `cp -r`: when destination is an existing directory (or a symlink to one), the copy goes inside it, named after source; otherwise destination is the copy's path. Relative paths use the filesystem working directory. Source symlinks are c… - [Find files and directories](https://docs.blaxel.ai/api-reference/filesystem/find-files-and-directories.md): Finds files and directories using the find command. - [List multipart uploads](https://docs.blaxel.ai/api-reference/filesystem/list-multipart-uploads.md): List all active multipart uploads - [Abort multipart upload](https://docs.blaxel.ai/api-reference/filesystem/abort-multipart-upload.md): Abort a multipart upload and clean up all parts - [Complete multipart upload](https://docs.blaxel.ai/api-reference/filesystem/complete-multipart-upload.md): Complete a multipart upload by assembling all parts - [Upload part](https://docs.blaxel.ai/api-reference/filesystem/upload-part.md): Upload a single part of a multipart upload. Re-uploading a part number replaces that part. Wait for the previous request for that part to finish before retrying. - [List parts](https://docs.blaxel.ai/api-reference/filesystem/list-parts.md): List all uploaded parts for a multipart upload - [Initiate multipart upload](https://docs.blaxel.ai/api-reference/filesystem/initiate-multipart-upload.md): Initiate a multipart upload session for a file - [Fuzzy search for files and directories](https://docs.blaxel.ai/api-reference/filesystem/fuzzy-search-for-files-and-directories.md): Ranks the files and directories under a path by how well their relative path fuzzy-matches `query` (fzf algorithm: the query's characters must appear in order, not necessarily next to each other), best match first. Fuzzy search is for "jump to file" lookups from a partial name. The `patterns` parame… - [Get file or directory information](https://docs.blaxel.ai/api-reference/filesystem/get-file-or-directory-information.md): Get content of a file or listing of a directory. Use Accept header to control response format for files. - [Create or update a file or directory](https://docs.blaxel.ai/api-reference/filesystem/create-or-update-a-file-or-directory.md): Create or update a file or directory. - [Delete file or directory](https://docs.blaxel.ai/api-reference/filesystem/delete-file-or-directory.md): Delete a file or directory - [Stat a file or directory](https://docs.blaxel.ai/api-reference/filesystem/stat-a-file-or-directory.md): Returns the metadata of a file or directory as headers, with no body. This checks stat availability, not permission to read file contents or list a directory. When the path does not exist or its metadata cannot be accessed, the response is an empty 200 without the X-File-Type header. - [Get directory tree](https://docs.blaxel.ai/api-reference/filesystem/get-directory-tree.md): List a directory. Without query parameters, `files` and `subdirectories` hold its direct children. - [Create or update directory tree](https://docs.blaxel.ai/api-reference/filesystem/create-or-update-directory-tree.md): Create or update multiple files within a directory tree structure. Idempotent: existing files are overwritten, so retrying the same request is safe. - [Delete directory tree](https://docs.blaxel.ai/api-reference/filesystem/delete-directory-tree.md): Delete a directory tree recursively - [Stream file modification events in a directory](https://docs.blaxel.ai/api-reference/filesystem/stream-file-modification-events-in-a-directory.md): Streams change events for a directory until the client disconnects. - [Start monitoring ports for a process](https://docs.blaxel.ai/api-reference/network/start-monitoring-ports-for-a-process.md): Start monitoring for new ports opened by a process - [Stop monitoring ports for a process](https://docs.blaxel.ai/api-reference/network/stop-monitoring-ports-for-a-process.md): Stop monitoring for new ports opened by a process - [Get open ports for a process](https://docs.blaxel.ai/api-reference/network/get-open-ports-for-a-process.md): Get a list of all open ports for a process - [Disconnect tunnel](https://docs.blaxel.ai/api-reference/network/disconnect-tunnel.md): Stop the network tunnel and restore the original network configuration. WARNING: After disconnecting, the sandbox will lose all outbound internet connectivity (no egress). Inbound connections to the sandbox will still work. Use PUT /network/tunnel/config to re-establish the tunnel. - [Update tunnel configuration](https://docs.blaxel.ai/api-reference/network/update-tunnel-configuration.md): Apply a new tunnel configuration on the fly. The existing tunnel is torn down and a new one is established. This endpoint is write-only; there is no corresponding GET to read the config back. - [List all processes](https://docs.blaxel.ai/api-reference/process/list-all-processes.md): Get a list of all running and completed processes - [Execute a command](https://docs.blaxel.ai/api-reference/process/execute-a-command.md): Execute a command and return process information. - [Get process by identifier](https://docs.blaxel.ai/api-reference/process/get-process-by-identifier.md): Get information about a process by its PID or name - [Stop a process](https://docs.blaxel.ai/api-reference/process/stop-a-process.md): Request graceful termination. Poll GET /process/{identifier} until terminal status confirms the managed process has exited. - [Kill a process](https://docs.blaxel.ai/api-reference/process/kill-a-process.md): Request forceful termination. Poll GET /process/{identifier} until terminal status confirms the managed process has exited. - [Get process logs](https://docs.blaxel.ai/api-reference/process/get-process-logs.md): Get the stdout and stderr output of a process - [Stream process logs in real time](https://docs.blaxel.ai/api-reference/process/stream-process-logs-in-real-time.md): Streams the stdout and stderr output of a process in real time: the output so far, then live output as the process writes it. Closes when the process exits or the client disconnects. By default, output is plain text with `stdout:` or `stderr:` prefixes at the start of each source stream's lines. Par… - [Write to a process's stdin](https://docs.blaxel.ai/api-reference/process/write-to-a-processs-stdin.md): Write the raw request body to the stdin of a process started with "stdin": true. Bytes are forwarded verbatim, so include the trailing newline your protocol expects. Sequential requests keep their order; each body is written atomically with respect to other writers. The pipe does not survive a sandb… - [Close a process's stdin](https://docs.blaxel.ai/api-reference/process/close-a-processs-stdin.md): Send EOF to the process by closing its stdin pipe. Idempotent. For stdio protocols such as MCP this is the clean shutdown path. - [Wait for a process to finish](https://docs.blaxel.ai/api-reference/process/wait-for-a-process-to-finish.md): Hold the request until the process is over for good (no restart to come) or the timeout expires, then return the process like GET /process/{identifier}. A process still running after the timeout comes back with status running: call again. Replaces polling GET /process/{identifier}. - [Blaxel SDKs overview](https://docs.blaxel.ai/sdk-reference/introduction.md): Use the Blaxel SDKs for TypeScript, Python, and Go to programmatically manage sandboxes, agents, MCP servers, jobs, and other resources. - [TypeScript SDK](https://docs.blaxel.ai/sdk-reference/sdk-ts.md): Install and use the Blaxel TypeScript SDK to programmatically manage sandboxes, agents, MCP servers, jobs, and other resources from Node.js. - [Python SDK](https://docs.blaxel.ai/sdk-reference/sdk-python.md): Install and use the Blaxel Python SDK to programmatically manage sandboxes, agents, MCP servers, jobs, and other workspace resources from Python. - [Go SDK](https://docs.blaxel.ai/sdk-reference/sdk-go.md): Install and use the Blaxel Go SDK to programmatically manage sandboxes, agents, MCP servers, jobs, and other workspace resources from Go. - [Blaxel CLI overview](https://docs.blaxel.ai/cli-reference/introduction.md): Install the Blaxel CLI (bl) to manage sandboxes, agents, MCP servers, jobs, and other resources from your terminal, with auth and command reference. - [bl apply](https://docs.blaxel.ai/cli-reference/commands/bl_apply.md) - [bl chat](https://docs.blaxel.ai/cli-reference/commands/bl_chat.md) - [bl completion](https://docs.blaxel.ai/cli-reference/commands/bl_completion.md) - [bl connect](https://docs.blaxel.ai/cli-reference/commands/bl_connect.md) - [bl connect sandbox](https://docs.blaxel.ai/cli-reference/commands/bl_connect_sandbox.md) - [bl delete](https://docs.blaxel.ai/cli-reference/commands/bl_delete.md) - [bl delete agent](https://docs.blaxel.ai/cli-reference/commands/bl_delete_agent.md) - [bl delete application](https://docs.blaxel.ai/cli-reference/commands/bl_delete_application.md) - [bl delete drive](https://docs.blaxel.ai/cli-reference/commands/bl_delete_drive.md) - [bl delete function](https://docs.blaxel.ai/cli-reference/commands/bl_delete_function.md) - [bl delete image](https://docs.blaxel.ai/cli-reference/commands/bl_delete_image.md) - [bl delete integrationconnection](https://docs.blaxel.ai/cli-reference/commands/bl_delete_integrationconnection.md) - [bl delete job](https://docs.blaxel.ai/cli-reference/commands/bl_delete_job.md) - [bl delete model](https://docs.blaxel.ai/cli-reference/commands/bl_delete_model.md) - [bl delete policy](https://docs.blaxel.ai/cli-reference/commands/bl_delete_policy.md) - [bl delete preview](https://docs.blaxel.ai/cli-reference/commands/bl_delete_preview.md) - [bl delete previewtoken](https://docs.blaxel.ai/cli-reference/commands/bl_delete_previewtoken.md) - [bl delete sandbox](https://docs.blaxel.ai/cli-reference/commands/bl_delete_sandbox.md) - [bl delete snapshot](https://docs.blaxel.ai/cli-reference/commands/bl_delete_snapshot.md) - [bl delete volume](https://docs.blaxel.ai/cli-reference/commands/bl_delete_volume.md) - [bl delete volumetemplate](https://docs.blaxel.ai/cli-reference/commands/bl_delete_volumetemplate.md) - [bl deploy](https://docs.blaxel.ai/cli-reference/commands/bl_deploy.md) - [bl drive](https://docs.blaxel.ai/cli-reference/commands/bl_drive.md) - [bl drive create](https://docs.blaxel.ai/cli-reference/commands/bl_drive_create.md) - [bl drive delete](https://docs.blaxel.ai/cli-reference/commands/bl_drive_delete.md) - [bl drive get](https://docs.blaxel.ai/cli-reference/commands/bl_drive_get.md) - [bl drive list](https://docs.blaxel.ai/cli-reference/commands/bl_drive_list.md) - [bl drive mount](https://docs.blaxel.ai/cli-reference/commands/bl_drive_mount.md) - [bl drive mounts](https://docs.blaxel.ai/cli-reference/commands/bl_drive_mounts.md) - [bl drive unmount](https://docs.blaxel.ai/cli-reference/commands/bl_drive_unmount.md) - [bl fork](https://docs.blaxel.ai/cli-reference/commands/bl_fork.md) - [bl get](https://docs.blaxel.ai/cli-reference/commands/bl_get.md) - [bl get agents](https://docs.blaxel.ai/cli-reference/commands/bl_get_agents.md) - [bl get applications](https://docs.blaxel.ai/cli-reference/commands/bl_get_applications.md) - [bl get drives](https://docs.blaxel.ai/cli-reference/commands/bl_get_drives.md) - [bl get functions](https://docs.blaxel.ai/cli-reference/commands/bl_get_functions.md) - [bl get image](https://docs.blaxel.ai/cli-reference/commands/bl_get_image.md) - [bl get integrationconnections](https://docs.blaxel.ai/cli-reference/commands/bl_get_integrationconnections.md) - [bl get jobs](https://docs.blaxel.ai/cli-reference/commands/bl_get_jobs.md) - [bl get mcp-hub](https://docs.blaxel.ai/cli-reference/commands/bl_get_mcp-hub.md) - [bl get models](https://docs.blaxel.ai/cli-reference/commands/bl_get_models.md) - [bl get policies](https://docs.blaxel.ai/cli-reference/commands/bl_get_policies.md) - [bl get previews](https://docs.blaxel.ai/cli-reference/commands/bl_get_previews.md) - [bl get previewtokens](https://docs.blaxel.ai/cli-reference/commands/bl_get_previewtokens.md) - [bl get sandbox-hub](https://docs.blaxel.ai/cli-reference/commands/bl_get_sandbox-hub.md) - [bl get sandboxes](https://docs.blaxel.ai/cli-reference/commands/bl_get_sandboxes.md) - [bl get snapshots](https://docs.blaxel.ai/cli-reference/commands/bl_get_snapshots.md) - [bl get templates](https://docs.blaxel.ai/cli-reference/commands/bl_get_templates.md) - [bl get volumes](https://docs.blaxel.ai/cli-reference/commands/bl_get_volumes.md) - [bl get volumetemplates](https://docs.blaxel.ai/cli-reference/commands/bl_get_volumetemplates.md) - [bl login](https://docs.blaxel.ai/cli-reference/commands/bl_login.md) - [bl logout](https://docs.blaxel.ai/cli-reference/commands/bl_logout.md) - [bl logs](https://docs.blaxel.ai/cli-reference/commands/bl_logs.md) - [bl mcp](https://docs.blaxel.ai/cli-reference/commands/bl_mcp.md) - [bl new](https://docs.blaxel.ai/cli-reference/commands/bl_new.md) - [bl push](https://docs.blaxel.ai/cli-reference/commands/bl_push.md) - [bl run](https://docs.blaxel.ai/cli-reference/commands/bl_run.md) - [bl serve](https://docs.blaxel.ai/cli-reference/commands/bl_serve.md) - [bl setup](https://docs.blaxel.ai/cli-reference/commands/bl_setup.md) - [bl share](https://docs.blaxel.ai/cli-reference/commands/bl_share.md) - [bl share image](https://docs.blaxel.ai/cli-reference/commands/bl_share_image.md) - [bl skills](https://docs.blaxel.ai/cli-reference/commands/bl_skills.md) - [bl skills autoupdate](https://docs.blaxel.ai/cli-reference/commands/bl_skills_autoupdate.md) - [bl skills install](https://docs.blaxel.ai/cli-reference/commands/bl_skills_install.md) - [bl skills status](https://docs.blaxel.ai/cli-reference/commands/bl_skills_status.md) - [bl skills update](https://docs.blaxel.ai/cli-reference/commands/bl_skills_update.md) - [bl token](https://docs.blaxel.ai/cli-reference/commands/bl_token.md) - [bl unshare](https://docs.blaxel.ai/cli-reference/commands/bl_unshare.md) - [bl unshare image](https://docs.blaxel.ai/cli-reference/commands/bl_unshare_image.md) - [bl upgrade](https://docs.blaxel.ai/cli-reference/commands/bl_upgrade.md) - [bl version](https://docs.blaxel.ai/cli-reference/commands/bl_version.md) - [bl workspaces](https://docs.blaxel.ai/cli-reference/commands/bl_workspaces.md) - [blaxel.toml deployment configuration file reference](https://docs.blaxel.ai/deployment-reference.md): Complete reference for the blaxel.toml configuration file, including resource types, build settings, runtime options, environment variables, and volumes. ## OpenAPI Specs - [controlplane](/api-reference/controlplane.yml) - [openapi](https://raw.githubusercontent.com/blaxel-ai/sandbox/refs/heads/main/sandbox-api/docs/openapi.yml) ## Optional - [Integrations directory](https://blaxel.ai/integrations) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.