# VMS > Tutorials, task guides, reference, and explanations for workspaces, accounts, the API, MCP, and AI agents. - [Introduction](https://vms.dev/docs/index.md): Set up a workspace, connect an AI agent, complete a task, or find a reference. - [Set up your first workspace](https://vms.dev/docs/quickstart.md): Sign in, create a workspace, and invite a member. - [Use a sandbox from TypeScript](https://vms.dev/docs/sdk-quickstart.md): Install the TypeScript SDK, create a sandbox, run a command, write files, connect with SSH, and delete the sandbox. - [Use a sandbox from your terminal](https://vms.dev/docs/cli-quickstart.md): Install the vms command line tool, sign in with your browser, create a sandbox, run a command, copy a file, connect with SSH, and delete the sandbox. - [Connect an MCP client](https://vms.dev/docs/install-mcp.md): Connect Claude, Cursor, Visual Studio Code, or another MCP client to your workspaces, and use its tools. - [Agent skills](https://vms.dev/docs/agent-skills.md): Instructions that an AI agent reads to sign up and use your workspaces. - [Register an agent with auth.md](https://vms.dev/docs/api-reference/agent-registration.md): Let an AI agent register for a user, get a token, and call the MCP server, with no copied API key. - [How-to guides](https://vms.dev/docs/guides.md): Find the guide for a workspace or account task. - [Create, get, and delete a sandbox](https://vms.dev/docs/sandboxes/create-and-delete.md): Create a sandbox with the REST API, wait until it is running, and delete it. - [List, find, and label sandboxes](https://vms.dev/docs/sandboxes/list-and-label.md): Give sandboxes names and labels, find a sandbox by its name, list sandboxes page by page, and create or delete many sandboxes in one request. - [Stop and resume a sandbox](https://vms.dev/docs/sandboxes/stop-and-resume.md): Stop a sandbox to stop its billing and keep its files, run a script before the stop, and resume the sandbox later, with a new size if you want. - [Fork a sandbox](https://vms.dev/docs/sandboxes/fork.md): Make one or more new sandboxes from the files and the environment variables of a running or stopped sandbox. - [Save a sandbox as a template](https://vms.dev/docs/sandboxes/templates.md): Save the files of a sandbox as a named template, create many sandboxes from it, share it with another workspace, and rename or delete the template. - [Read the files of a snapshot](https://vms.dev/docs/sandboxes/snapshot-files.md): List a folder of a snapshot, download one file or a folder as a tar, or download the whole snapshot, with no running sandbox. - [Stop a sandbox on its own](https://vms.dev/docs/sandboxes/auto-stop.md): Set the time when a sandbox stops on its own, extend it, or turn it off, so that a sandbox that you forget does not run up a bill. - [Run commands in a sandbox](https://vms.dev/docs/sandboxes/run-commands.md): Run a command in a sandbox, stream its output, send stdin, reattach to a detached command, and kill a command. - [Read and write files in a sandbox](https://vms.dev/docs/sandboxes/files.md): Read, write, and delete files and folders in a sandbox, and upload a tar into a folder. - [Connect to a sandbox with SSH](https://vms.dev/docs/sandboxes/ssh.md): Add your SSH key to a sandbox, then open a shell with ssh @ssh.vms.dev or at the IPv6 address of the sandbox. - [Open a port of a sandbox on a public URL](https://vms.dev/docs/sandboxes/urls.md): Give a port of a sandbox an HTTPS URL, open it with its token or to everyone, and use WebSockets through it. - [See the desktop of a sandbox](https://vms.dev/docs/sandboxes/desktop.md): Open the desktop of a running sandbox, or only its Chrome window, in a browser tab at 1080p and 60 frames each second, with sound. - [Get webhooks when a sandbox changes state](https://vms.dev/docs/sandboxes/webhooks.md): Add a webhook endpoint, check the signature of each request, and answer it. - [Run eve agents in sandboxes](https://vms.dev/docs/sandboxes/eve.md): Install the @vms.dev/eve sandbox provider, give an eve agent a sandbox for each session, build a template at eve build, and see what happens when the session sleeps, resumes, and ends. - [Use sandboxes in the app](https://vms.dev/docs/sandboxes/in-the-app.md): Find the sandboxes of your workspace on the Sandboxes page, see the details of a sandbox, fork it, save it as a template, open its desktop, browse its snapshots, and stop, resume, or delete one or many sandboxes. - [Use templates in the app](https://vms.dev/docs/sandboxes/templates-in-the-app.md): Find the templates of your workspace on the Templates page, create a sandbox from a template, share it with a code, and rename or delete one or many templates. - [Change the workspace settings](https://vms.dev/docs/workspace/settings.md): Change the name, the company website, the URL, and the default language of a workspace, or delete it. - [Add and remove members](https://vms.dev/docs/workspace/members.md): Invite people to a workspace, change their roles, and remove them. - [Create and revoke API keys](https://vms.dev/docs/workspace/api-keys.md): Create an API key with scopes, so that a program can call the API for your workspace. Revoke a key when you do not need it. - [Choose a plan, and see invoices and payments](https://vms.dev/docs/workspace/billing.md): Choose a plan or start the 14-day trial with Stripe Checkout, and change the plan in the Stripe Customer Portal. See the billing info, the cards, the invoices, and the charges of the workspace. - [Top up the balance, and see the usage](https://vms.dev/docs/workspace/usage-and-balance.md): Top up the balance of a workspace, turn on automatic top-up, set a monthly spending limit, and see the cost of each sandbox and each label. Read the usage with the API. - [Sign in and sign out](https://vms.dev/docs/account/sign-in.md): Sign in with a link that you get by email, and sign out from the user menu. - [Change your profile](https://vms.dev/docs/account/profile.md): Change your name, avatar, language, time zone, and theme, and see your connected agents. - [Connect an AI agent with a code](https://vms.dev/docs/account/connect-agent.md): Enter the 6-digit code that an AI agent gives you, so that it can act as you. See and disconnect your agents. - [Navigation reference](https://vms.dev/docs/reference/navigation.md): The areas of the rail, the sidebar pages, and the menus. - [Workspace access reference](https://vms.dev/docs/reference/workspace-access.md): The roles of a workspace, their permissions, and the scopes and limits of API keys. - [Workspace settings reference](https://vms.dev/docs/reference/workspace-settings.md): The rules for the workspace name, the company website, the URL, and the default language. - [Plans reference](https://vms.dev/docs/reference/plans.md): The price, the limits, and the trial of each plan, and the price of each sandbox size. - [Sandbox network reference](https://vms.dev/docs/reference/sandbox-network.md): The addresses of a sandbox, the traffic that it can send and receive, and its rate limits. - [Saved files reference](https://vms.dev/docs/reference/saved-files.md): The files that each snapshot of a sandbox saves and does not save, the .vmsignore file, the snapshot fields, and when saved files are deleted. - [Health and recovery reference](https://vms.dev/docs/reference/health-and-recovery.md): What happens to a sandbox when its host stops, when its kernel crashes, or when its guest agent does not answer: health, errorReason, lastReboot, and the recover operation. - [Webhook events](https://vms.dev/docs/reference/webhook-events.md): The events, the request body, the headers, and the retry times of webhooks. - [TypeScript SDK reference](https://vms.dev/docs/reference/typescript-sdk.md): The client options, the methods for each API route, the helpers, the errors, and the webhook check of @vms.dev/sdk. - [CLI reference](https://vms.dev/docs/reference/cli.md): Install the vms command line tool, sign in with your browser or an API key, and use each command: new, ls, ssh, exec, cp, stop, resume, rm, url, fork, template, snapshot, and desktop. - [eve provider reference](https://vms.dev/docs/reference/eve-provider.md): The options of VmsSandbox.environment() and open(), the sandbox and template names, the session state, and the API calls of each eve lifecycle step in @vms.dev/eve. - [MCP reference](https://vms.dev/docs/reference/workspace-mcp.md): The MCP endpoint, the OAuth settings, the access scopes, and the tools. - [Agent registration reference](https://vms.dev/docs/reference/agent-registration.md): The auth.md endpoints, registration methods, tokens, limits, errors, and revocation. - [Workspaces, members, and API keys](https://vms.dev/docs/explanation/workspaces.md): How a workspace holds its members, their roles, and its API keys. - [How programs and agents get access](https://vms.dev/docs/explanation/agent-access.md): API keys, MCP sign-in, and agent registration: what each gives access to, and why. - [How billing works](https://vms.dev/docs/explanation/billing.md): How the plan, the trial, and the usage credit of a workspace work, and how the terms compare with boat.dev. - [llms.txt](https://vms.dev/docs/links/llms.md) - [llms-full.txt](https://vms.dev/docs/links/llms-full.md) - [Email us](https://vms.dev/docs/links/email.md) - [Make your first API request](https://vms.dev/docs/api-reference/first-request.md): Create an API key and read your workspace with the REST API. - [API introduction](https://vms.dev/docs/api-reference/introduction.md): Authentication, scopes, errors, and limits of the REST API. - [Get the workspace](https://vms.dev/docs/api-reference/workspace/get-the-workspace.md): Returns the workspace of the API key. Needs the `workspace:read` scope. - [List workspace changes](https://vms.dev/docs/api-reference/workspace/list-workspace-changes.md): Lists the changes of the workspace, newest first: the workspace was created, renamed, or got a new website, and members joined, changed role, or left. To get the next page, send the nextCursor of the last page. Needs the `workspace:read` scope. - [List sandboxes](https://vms.dev/docs/api-reference/sandboxes/list-sandboxes.md): Lists the sandboxes of the workspace, newest first. A deleted sandbox is not in the list. Filter by state, name, start of the name, and label. To find a sandbox by its name, send `name`. To get the next page, send the nextCursor of the last page with the same filters and order. Needs the `sandboxes:… - [Create a sandbox](https://vms.dev/docs/api-reference/sandboxes/create-a-sandbox.md): Creates a sandbox of the size that you send. Send `template` to start the sandbox with the files of a template: its ID, its name, or a share code from another workspace. The sandbox takes a warm slot, or waits a few seconds for a new slot when a host has room, and moves through `creating` and `start… - [Get a sandbox](https://vms.dev/docs/api-reference/sandboxes/get-a-sandbox.md): Returns one sandbox with its latest operation. After a delete, the first request returns the sandbox with the state `deleted`, and each later request answers `404`. Needs the `sandboxes:read` scope. - [Update a sandbox](https://vms.dev/docs/api-reference/sandboxes/update-a-sandbox.md): Changes the name, the labels, or the state of a sandbox. The request changes only the fields that you send. The labels that you send replace all labels of the sandbox. Send `name: null` to remove the name. - [Delete a sandbox](https://vms.dev/docs/api-reference/sandboxes/delete-a-sandbox.md): Moves the sandbox to `deleting`, then to `deleted`, and removes its data. A second delete while the sandbox is `deleting` returns the same sandbox. Needs the `sandboxes:write` scope. - [Create many sandboxes](https://vms.dev/docs/api-reference/sandboxes/create-many-sandboxes.md): Creates up to 500 sandboxes in one request. Give each item the fields of a create. The API creates the items one after the other. It returns a result for each item, in the sequence of the items: the ID of the new sandbox, or the error message. Needs the `sandboxes:write` scope. - [Update many sandboxes](https://vms.dev/docs/api-reference/sandboxes/update-many-sandboxes.md): Changes up to 500 sandboxes in one request. Give each item the `id` of a sandbox and the fields of an update, such as `state: stopped` to stop it. The API changes the items one after the other. It returns a result for each item, in the sequence of the items: the ID, and an error message if the chang… - [Delete many sandboxes](https://vms.dev/docs/api-reference/sandboxes/delete-many-sandboxes.md): Deletes up to 500 sandboxes in one request. Each sandbox moves to `deleting`, then to `deleted`. The API returns a result for each ID, in the sequence of the IDs: the ID, and an error message if the delete failed. Needs the `sandboxes:write` scope. - [List the snapshots of a sandbox](https://vms.dev/docs/api-reference/sandboxes/list-the-snapshots-of-a-sandbox.md): Lists the saved snapshots of a sandbox, newest first. A running sandbox saves its changed files each minute. A minute with no change adds no snapshot. Needs the `sandboxes:read` scope. - [Get a snapshot](https://vms.dev/docs/api-reference/sandboxes/get-a-snapshot.md): Returns one saved snapshot of a sandbox. Needs the `sandboxes:read` scope. - [List the SSH keys of a sandbox](https://vms.dev/docs/api-reference/sandboxes/list-the-ssh-keys-of-a-sandbox.md): Lists the public keys that can connect to the sandbox with SSH, oldest first. Needs the `sandboxes:ssh` scope. - [Add an SSH key to a sandbox](https://vms.dev/docs/api-reference/sandboxes/add-an-ssh-key-to-a-sandbox.md): Adds a public key to the sandbox. Then `ssh @ssh.vms.dev` with this key opens a shell in the sandbox as `user`, and so does SSH to the IPv6 address of the sandbox. A running sandbox gets the key in a few seconds. A sandbox can have 20 keys. Needs the `sandboxes:ssh` scope. - [Delete an SSH key](https://vms.dev/docs/api-reference/sandboxes/delete-an-ssh-key.md): Removes the key from the sandbox. New connections with the key fail. Needs the `sandboxes:ssh` scope. - [Add many SSH keys to a sandbox](https://vms.dev/docs/api-reference/sandboxes/add-many-ssh-keys-to-a-sandbox.md): Adds up to 500 public keys to the sandbox in one request. The API returns a result for each item, in the sequence of the items: the ID of the new key, or an error message. A sandbox can have 20 keys. Needs the `sandboxes:ssh` scope. - [Delete many SSH keys of a sandbox](https://vms.dev/docs/api-reference/sandboxes/delete-many-ssh-keys-of-a-sandbox.md): Deletes up to 500 keys of the sandbox in one request. The API returns a result for each ID, in the sequence of the IDs. Needs the `sandboxes:ssh` scope. - [List the URLs of a sandbox](https://vms.dev/docs/api-reference/sandboxes/list-the-urls-of-a-sandbox.md): Lists the HTTPS URLs of the ports of a sandbox, by port. Needs the `sandboxes:read` scope. - [Create a URL for a port](https://vms.dev/docs/api-reference/sandboxes/create-a-url-for-a-port.md): Gives a port of the sandbox an HTTPS URL, such as `https://agent-42-3000-k3m7q2v9.vmsdev.run`. The URL needs its token, unless you send `public: true`. A sandbox has up to 20 URLs. Needs the `sandboxes:write` scope. - [Get a URL of a sandbox](https://vms.dev/docs/api-reference/sandboxes/get-a-url-of-a-sandbox.md): Returns one URL of a sandbox. Needs the `sandboxes:read` scope. - [Update a URL of a sandbox](https://vms.dev/docs/api-reference/sandboxes/update-a-url-of-a-sandbox.md): Opens the URL to everyone with `public: true`, or adds the token gate again with `public: false`. The token does not change. Needs the `sandboxes:write` scope. - [Delete a URL of a sandbox](https://vms.dev/docs/api-reference/sandboxes/delete-a-url-of-a-sandbox.md): Deletes the URL. The port in the sandbox does not change. Needs the `sandboxes:write` scope. - [Create many URLs of a sandbox](https://vms.dev/docs/api-reference/sandboxes/create-many-urls-of-a-sandbox.md): Gives up to 500 ports of the sandbox a URL in one request. The API returns a result for each item, in the sequence of the items: the ID of the new URL, or an error message. A sandbox can have 20 URLs. Needs the `sandboxes:write` scope. - [Update many URLs of a sandbox](https://vms.dev/docs/api-reference/sandboxes/update-many-urls-of-a-sandbox.md): Changes up to 500 URLs of the sandbox in one request. Each item has the `id` of a URL and the fields of an update. The API returns a result for each item, in the sequence of the items. Needs the `sandboxes:write` scope. - [Delete many URLs of a sandbox](https://vms.dev/docs/api-reference/sandboxes/delete-many-urls-of-a-sandbox.md): Deletes up to 500 URLs of the sandbox in one request. The API returns a result for each ID, in the sequence of the IDs. Needs the `sandboxes:write` scope. - [Open the desktop of a sandbox](https://vms.dev/docs/api-reference/sandboxes/open-the-desktop-of-a-sandbox.md): Gives a URL that shows the desktop of a running sandbox in a browser, at 1080p and 60 frames each second. The URL contains a token. It stops working 10 minutes after the create if nobody opens it. A browser that opens it keeps the desktop for 12 hours, while the sandbox runs. Needs the `sandboxes:de… - [Get the usage of a sandbox](https://vms.dev/docs/api-reference/sandboxes/get-the-usage-of-a-sandbox.md): Returns the capacity-unit seconds and the cost of one sandbox in a window. The default window is the current month (UTC). Needs the `sandboxes:read` scope. - [Get an operation](https://vms.dev/docs/api-reference/sandboxes/get-an-operation.md): Returns one operation on a sandbox, such as a create or a delete, with its status. Needs the `sandboxes:read` scope. - [List templates](https://vms.dev/docs/api-reference/templates/list-templates.md): Returns the templates of the workspace, newest first. Needs the `templates:read` or the `templates:write` scope. - [Create a template](https://vms.dev/docs/api-reference/templates/create-a-template.md): Saves the files of a running or stopped sandbox as a template. The template has the status `saving`, then `ready` or `failed`. For a running sandbox, the template takes a new snapshot first, so that it has the latest writes. The template is a full copy: it does not change when the sandbox changes or… - [Get a template](https://vms.dev/docs/api-reference/templates/get-a-template.md): Returns one template. Needs the `templates:read` or the `templates:write` scope. - [Update a template](https://vms.dev/docs/api-reference/templates/update-a-template.md): Renames the template. Needs the `templates:write` scope. - [Delete a template](https://vms.dev/docs/api-reference/templates/delete-a-template.md): Deletes the template. Its saved files go after each sandbox from the template has its own full snapshot. Sandboxes from the template do not change. Needs the `templates:write` scope. - [Create many templates](https://vms.dev/docs/api-reference/templates/create-many-templates.md): Saves up to 500 templates in one request. The API returns a result for each item, in the sequence of the items. Needs the `templates:write` and the `snapshots:read` scopes, because a template copies the files of the sandbox. - [Update many templates](https://vms.dev/docs/api-reference/templates/update-many-templates.md): Renames up to 500 templates in one request. Each item has the `id` of a template and the fields of an update. The API returns a result for each item, in the sequence of the items. Needs the `templates:write` scope. - [Delete many templates](https://vms.dev/docs/api-reference/templates/delete-many-templates.md): Deletes up to 500 templates in one request. The API returns a result for each ID, in the sequence of the IDs. Needs the `templates:write` scope. - [List the share codes of a template](https://vms.dev/docs/api-reference/templates/list-the-share-codes-of-a-template.md): Returns the share codes of the template, oldest first. The list shows the last 4 characters of each code, not the code. Needs the `templates:read` or the `templates:write` scope. - [Create a share code](https://vms.dev/docs/api-reference/templates/create-a-share-code.md): Makes a code that lets another workspace create sandboxes from the template. The other workspace sends the code as `template` when it creates a sandbox. It cannot see, list, or download the template or its files. The response shows the code one time. A template can have 20 share codes. Needs the `te… - [Revoke a share code](https://vms.dev/docs/api-reference/templates/revoke-a-share-code.md): Revokes the share code. A create with the code then fails. Sandboxes that were created with the code continue to run. Needs the `templates:write` scope. - [Revoke many share codes](https://vms.dev/docs/api-reference/templates/revoke-many-share-codes.md): Revokes up to 500 share codes of the template in one request. The API returns a result for each ID, in the sequence of the IDs. Needs the `templates:write` scope. - [List a folder of a snapshot](https://vms.dev/docs/api-reference/snapshots/list-a-folder-of-a-snapshot.md): Returns the saved files and folders in one folder of a snapshot. A snapshot holds the saved files: the files and folders that are different from the base image. It works with no running sandbox, also after the sandbox is deleted, until its saved files are deleted. Needs the `snapshots:read` scope. - [Download a file or a folder of a snapshot](https://vms.dev/docs/api-reference/snapshots/download-a-file-or-a-folder-of-a-snapshot.md): Returns the content of a file. For a folder, returns a tar of the folder and of each saved file and folder in it. A snapshot holds the saved files: the files and folders that are different from the base image. It works with no running sandbox, also after the sandbox is deleted, until its saved files… - [Download a snapshot](https://vms.dev/docs/api-reference/snapshots/download-a-snapshot.md): Streams a tar of each saved file and folder of a snapshot. The names in the tar have no leading /. A snapshot holds the saved files: the files and folders that are different from the base image. It works with no running sandbox, also after the sandbox is deleted, until its saved files are deleted. N… - [List webhook endpoints](https://vms.dev/docs/api-reference/webhooks/list-webhook-endpoints.md): Returns the webhook endpoints of the workspace, oldest first. Needs the `webhooks:read` or the `webhooks:write` scope. - [Create a webhook endpoint](https://vms.dev/docs/api-reference/webhooks/create-a-webhook-endpoint.md): Adds an endpoint that gets a signed POST request for each event. The response has the signing secret. You see the secret only one time. A workspace can have 10 endpoints. Needs the `webhooks:write` scope. - [Get a webhook endpoint](https://vms.dev/docs/api-reference/webhooks/get-a-webhook-endpoint.md): Returns one webhook endpoint, without its secret. Needs the `webhooks:read` or the `webhooks:write` scope. - [Update a webhook endpoint](https://vms.dev/docs/api-reference/webhooks/update-a-webhook-endpoint.md): Changes only the fields that you send. Set `enabled` to false to stop the events. Needs the `webhooks:write` scope. - [Delete a webhook endpoint](https://vms.dev/docs/api-reference/webhooks/delete-a-webhook-endpoint.md): Deletes the endpoint. Events that wait for a retry do not go to it. Needs the `webhooks:write` scope. - [Update many webhook endpoints](https://vms.dev/docs/api-reference/webhooks/update-many-webhook-endpoints.md): Changes up to 500 endpoints in one request. Each item has the `id` of an endpoint and the fields of an update. The API returns a result for each item, in the sequence of the items. Needs the `webhooks:write` scope. - [Delete many webhook endpoints](https://vms.dev/docs/api-reference/webhooks/delete-many-webhook-endpoints.md): Deletes up to 500 endpoints in one request. The API returns a result for each ID, in the sequence of the IDs. Needs the `webhooks:write` scope. - [Sandbox event](https://vms.dev/docs/api-reference/webhooks/sandbox-event.md): Each enabled endpoint that has the event type gets this request. Answer with a 2xx status within 10 seconds. If you do not, the request comes again, up to 8 attempts in total. - [Get the limits](https://vms.dev/docs/api-reference/limits/get-the-limits.md): Returns the limits of the workspace plan and the current use of each limit. A create above a limit answers `402 billing_required`, `403 size_not_allowed`, or `429 start_limit`. Needs the `sandboxes:read` scope. - [Get the usage](https://vms.dev/docs/api-reference/billing/get-the-usage.md): Returns the capacity-unit seconds and the cost of each minute, hour, or day in a window, and the credit and the balance of the workspace. Only running time that is not degraded costs money. Needs the `billing:read` scope. - [Run a command](https://vms.dev/docs/api-reference/commands/run-a-command.md): Runs a command in a running sandbox and streams its output as NDJSON until the command exits. A command has no time limit unless you send `timeoutSeconds`. If you disconnect, the command gets SIGKILL. Send `detached: true` to get the command at once and keep it running after you disconnect. Needs th… - [List commands](https://vms.dev/docs/api-reference/commands/list-commands.md): Returns the commands of the sandbox, the newest first. A sandbox keeps its 25 newest exited commands and each running command until it restarts. Needs the `sandboxes:exec` scope. - [Get a command](https://vms.dev/docs/api-reference/commands/get-a-command.md): Returns one command with its status and its exit result. Needs the `sandboxes:exec` scope. - [Stream the output of a command](https://vms.dev/docs/api-reference/commands/stream-the-output-of-a-command.md): Streams the events of a command as NDJSON, also after the command exited. Send `after` to get only the events with a higher `seq`. The stream ends at the `exit` event. A sandbox keeps the newest 4 MiB of events of each command. Needs the `sandboxes:exec` scope. - [Send stdin to a command](https://vms.dev/docs/api-reference/commands/send-stdin-to-a-command.md): Writes data to the stdin of a running command. The command must start with `stdin: true`. Send `eof: true` to close stdin. Needs the `sandboxes:exec` scope. - [Kill a command](https://vms.dev/docs/api-reference/commands/kill-a-command.md): Sends a signal to each process of the command. The default signal is SIGKILL. The answer comes when the command exits, or after 5 seconds. Needs the `sandboxes:exec` scope. - [Read a file](https://vms.dev/docs/api-reference/files/read-a-file.md): Returns the content of a file in a running sandbox. Needs the `sandboxes:files` scope. - [Write a file](https://vms.dev/docs/api-reference/files/write-a-file.md): Creates or replaces a file with the request body. Creates the missing folders of the path. The body can be up to 128 MiB. A larger body gets `413`. Needs the `sandboxes:files` scope. - [Delete a file or a folder](https://vms.dev/docs/api-reference/files/delete-a-file-or-a-folder.md): Deletes a file, or a folder and all of its content. You cannot delete the root folder. Needs the `sandboxes:files` scope. - [Upload a tar](https://vms.dev/docs/api-reference/files/upload-a-tar.md): Extracts a tar or a gzip tar into a folder. Creates the folder if it does not exist, and replaces the files that the tar contains. Send the content type `application/x-tar` or `application/gzip`. The body can be up to 128 MiB. A larger body gets `413`. Needs the `sandboxes:files` scope. - [Email us](https://vms.dev/docs/links/email.md) - [Changelog](https://vms.dev/docs/changelog.md): New features and changes that you can see. - [llms.txt](https://vms.dev/docs/links/llms.md) - [llms-full.txt](https://vms.dev/docs/links/llms-full.md) - [Email us](https://vms.dev/docs/links/email.md) ## OpenAPI Specs - [openapi](/docs/api-reference/openapi.json) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.