Delete Deployment

POSThttps://{organization}.blackbox.ai/dedicated/delete

Permanently delete a dedicated deployment.

Permanently delete a dedicated deployment. The underlying GPU replicas are torn down and the deployment record is removed.

This action is irreversible. In-flight requests are cancelled, the client-facing model id stops resolving, and any bare-slug requests that were auto-picking this deployment will need to re-pick another one (or return 404 deployment_not_found if none remain). To temporarily pause routing without losing state, use POST /dedicated/edit with patch: { enabled: false } instead.

Headers

Authorizationstringrequired

API Key of the form Bearer <api_key>. Must own the deployment.

Content-Typestringrequired

Must be set to application/json.

Request Body

deployment_idstringrequired

UUID of the deployment to delete.

Response

deletedboolean

Always true on a successful delete.

deployment_idstring

Echo of the deleted deployment's id.

Request Example

curl -X POST https://{organization}.blackbox.ai/dedicated/delete \
  -H "Authorization: Bearer $BLACKBOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "deployment_id": "9c8b7a6d-5e4f-3a2b-1c0d-ef1234567890"
  }'

import os
import requests

response = requests.post(
    "https://{organization}.blackbox.ai/dedicated/delete",
    headers={
        "Authorization": f"Bearer {os.environ['BLACKBOX_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={"deployment_id": "9c8b7a6d-5e4f-3a2b-1c0d-ef1234567890"},
)

print(response.json())

const response = await fetch("https://{organization}.blackbox.ai/dedicated/delete", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BLACKBOX_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    deployment_id: "9c8b7a6d-5e4f-3a2b-1c0d-ef1234567890",
  }),
});

const data = await response.json();
console.log(data);

Response Example

{
  "deleted": true,
  "deployment_id": "9c8b7a6d-5e4f-3a2b-1c0d-ef1234567890"
}

Error Codes

Status	Error	Description
400	`invalid_request`	Missing or malformed `deployment_id`.
401	`unauthorized`	Missing or invalid API key.
404	`deployment_not_found`	No deployment with that id owned by the caller.