Delete Files

DELETE/v1/sandbox/{sandbox_id}/files

DELETE/v1/sandbox/{'{sandbox_id}'}/files

Base URL *

Your instance endpoint, shown on the instance page in the dashboard. Each instance has its own host; there is no shared API host.

Authorization (Bearer token)

sandbox_id (path) *

Description

Deletes one or more files from the sandbox filesystem. Provide a list of absolute paths in the request body. All specified files are removed permanently and the operation cannot be undone.

Path Parameters

Parameter	Type	Required	Description
`sandbox_id`	`string`	Yes	Sandbox ID or name

Request Body

Property	Type	Required	Description
`paths`	`string[]`	Yes	Array of absolute file paths to delete

Responses

200 Success

Property	Type	Description
`status`	`string`	Always `"deleted"` on success

default An unexpected error response.

Property	Type	Description
`code`	`integer`
`message`	`string`
`details`	`object[]`

Request

curl -X DELETE "https://your-instance.example.com/v1/sandbox/sb_abc123/files" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "paths": ["/repo/temp.txt", "/repo/build/output.bin"]
  }'

const response = await fetch(
  "https://your-instance.example.com/v1/sandbox/sb_abc123/files",
  {
    method: "DELETE",
    headers: {
      Authorization: "Bearer <token>",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      paths: ["/repo/temp.txt", "/repo/build/output.bin"],
    }),
  }
);

const data = await response.json();
console.log(data); // { status: "deleted" }

import requests

response = requests.delete(
    "https://your-instance.example.com/v1/sandbox/sb_abc123/files",
    headers={"Authorization": "Bearer <token>"},
    json={
        "paths": ["/repo/temp.txt", "/repo/build/output.bin"],
    },
)

print(response.json())  # {"status": "deleted"}

Response

{"status": "deleted"}

{"code": 0, "message": "string", "details": [{"@type": "string"}]}