Skip to main content
DELETE
/
api
/
v1
/
sandbox
Bulk Delete Sandboxes Endpoint
curl --request DELETE \
  --url https://api.primeintellect.ai/api/v1/sandbox \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sandbox_ids": [
    "<string>"
  ],
  "labels": [
    "<string>"
  ],
  "team_id": "<string>",
  "user_id": "<string>",
  "all_users": false
}
'
{
  "message": "<string>",
  "succeeded": [
    "<string>"
  ],
  "failed": [
    {}
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.primeintellect.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Rate Limit

50 requests per 60 seconds per IP and token.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
sandbox_ids
string[] | null

List of sandbox IDs to delete

Required array length: 1 - 500 elements
​
labels
string[] | null

List of labels - delete all sandboxes with ALL these labels

Required array length: 1 - 50 elements
​
team_id
string | null

Scope deletion to sandboxes in this team. Required when all_users is true or when targeting another user's sandboxes.

​
user_id
string | null

Scope deletion to sandboxes owned by this user. Defaults to the authenticated caller unless all_users is true. Targeting another user's ID requires team admin role on team_id.

​
all_users
boolean
default:false

Delete sandboxes across all users in the given team_id. Requires team admin role on team_id.

Response

Successful Response

​
message
string
required
​
succeeded
string[]

List of successfully deleted sandbox IDs

​
failed
Failed · object[]

List of failed deletions with error messages