Skip to main content
DELETE
/
servers
/
:name
Delete Server
curl --request DELETE \
  --url https://api.example.com/servers/:name
{
  "status": "success",
  "message": "Server 'my-test-server' deleted successfully"
}

​
Endpoint

DELETE https://api.superbox.ai/api/v1/servers/:name

​
Authentication

This endpoint requires authentication. You must be the server owner.
Only the server owner can delete a server. This action is irreversible.

​
Path Parameters

​
name
string
required
Unique server identifier to delete. Example: weather-mcp, my-test-server

​
Response

​
status
string
"success" on success, "error" on failure
​
message
string
Deletion confirmation message

​
Examples

curl -X DELETE "https://api.superbox.ai/api/v1/servers/my-test-server" \
  -H "Authorization: Bearer $SUPERBOX_API_TOKEN"

​
Response Examples

{
  "status": "success",
  "message": "Server 'my-test-server' deleted successfully"
}

​
Before You Delete

Instead of deleting, you can mark your server as deprecated so existing users can migrate gracefully:
// Update description to indicate deprecation
await fetch(url, {
  method: 'PUT',
  headers,
  body: JSON.stringify({
    description: 'DEPRECATED - This server will be removed on 2025-12-20. Please migrate to alternative-server.'
  })
});
Save a local copy of your server metadata before deleting:
import json
import requests
import os

server_name = "my-test-server"
headers = {'Authorization': f'Bearer {os.getenv("SUPERBOX_API_TOKEN")}'}

# Get server details
response = requests.get(
    f'https://api.superbox.ai/api/v1/servers/{server_name}',
    headers=headers
)
server_data = response.json()['server']

# Save to file
with open(f'{server_name}_backup.json', 'w') as f:
    json.dump(server_data, f, indent=2)

print(f"Data saved to {server_name}_backup.json")
Consider notifying your users before deletion:
  • Post an announcement on your homepage
  • Update your README with a deprecation notice
  • Suggest alternative servers