List Stacks

Overview

Returns a list of all stacks associated with your ToolRouter account, including their configuration and server details.

Endpoint

GET https://api.toolrouter.ai/v1/stacks

Authentication

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

Authorization: Bearer YOUR_API_KEY

Response

array

Array of stack objects

Show Stack Object

string

Unique identifier for the stack

string

Human-readable name of the stack

object

Stack configuration settings

Show Configuration Object

boolean

Whether analytics are enabled for this stack

array

Array of servers added to this stack

Show Server Object

string

Name of the server

array

Array of tool IDs that are enabled for this server

string

ISO timestamp when the stack was created

string

ISO timestamp when the stack was last updated

Example Request

curl -X GET "https://api.toolrouter.ai/v1/stacks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

import requests

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}

response = requests.get(
    "https://api.toolrouter.ai/v1/stacks",
    headers=headers
)

stacks = response.json()

const response = await fetch('https://api.toolrouter.ai/v1/stacks', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});

const stacks = await response.json();

Example Response

[
  {
    "stack_id": "stack_123e4567-e89b-12d3-a456-426614174000",
    "stack_name": "Production Stack",
    "configuration": {
      "analytics_enabled": true
    },
    "servers": [
      {
        "server_name": "Gmail Server",
        "enabled_tools": [
          "gmail_send_email",
          "gmail_search_emails",
          "gmail_read_email"
        ]
      },
      {
        "server_name": "Google Calendar",
        "enabled_tools": [
          "calendar_list_events",
          "calendar_create_event"
        ]
      }
    ],
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-20T14:45:00Z"
  },
  {
    "stack_id": "stack_987f6543-e21c-34d5-b678-426614174001",
    "stack_name": "Development Stack",
    "configuration": {
      "analytics_enabled": false
    },
    "servers": [
      {
        "server_name": "Linear",
        "enabled_tools": [
          "linear_create_issue",
          "linear_search_issues"
        ]
      }
    ],
    "created_at": "2024-01-10T08:15:00Z",
    "updated_at": "2024-01-18T16:20:00Z"
  }
]

Error Responses

Invalid or missing API key

{
  "detail": "Unauthorized"
}

Rate limit exceeded

{
  "detail": "Too many requests"
}

Server error occurred

{
  "detail": "Failed to list stacks"
}

API Documentation

Stack Specific Endpoints

Account Management API

Stack Management

Server Management

Credentials Management

Tools Management

SDK

Overview

Endpoint

Authentication

Response

Example Request

Example Response

Error Responses

​Overview

​Endpoint

​Authentication

​Response

​Example Request

​Example Response

​Error Responses

Overview

Endpoint

Authentication

Response

Example Request

Example Response

Error Responses