Delete Stack

​

Overview

Permanently deletes a stack and all its associated data from your ToolRouter account. This action cannot be undone.

​

Endpoint

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

​

Authentication

This endpoint requires an API key. Include it in the Authorization header:

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"

​

Example Response

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

​

What Gets Deleted

When you delete a stack, the following data is permanently removed:

• 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

Before deleting a stack, consider:

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

If you accidentally delete a stack, you will need to:

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