Delete Stack

​

Overview

​

Endpoint

DELETE https://api.toolrouter.ai/v1/stacks/{stack_id}

​

Authentication

Authorization: Bearer YOUR_API_KEY

​

Path Parameters

​

Response

​

Example Request

curl -X DELETE "https://api.toolrouter.ai/v1/stacks/stack_123e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

headers = {
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.delete(
    "https://api.toolrouter.ai/v1/stacks/stack_123e4567-e89b-12d3-a456-426614174000",
    headers=headers
)

result = response.json()

const response = await fetch('https://api.toolrouter.ai/v1/stacks/stack_123e4567-e89b-12d3-a456-426614174000', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const result = await response.json();

​

Example Response

{
  "message": "Stack stack_123e4567-e89b-12d3-a456-426614174000 deleted successfully"
}

​

What Gets Deleted

• Stack configuration: All stack settings and metadata
• Server associations: All servers added to the stack
• Credentials: All stored credentials for servers in the stack
• Usage analytics: Historical usage data for the stack
• Secure endpoints: Any secure client endpoints created for the stack

​

Error Responses

{
  "detail": "Unauthorized"
}

{
  "detail": "Stack not found"
}

{
  "detail": "Too many requests"
}

{
  "detail": "Failed to delete stack"
}

​

Best Practices

1. Backup important data: Export any important configurations or credential information
2. Check dependencies: Ensure no applications are actively using this stack
3. Review usage: Check if the stack has been used recently
4. Alternative approach: Consider updating the stack instead of deleting it

​

Recovery

1. Create a new stack with the same configuration
2. Re-add all servers to the new stack
3. Re-configure all credentials
4. Update any applications to use the new stack