Create Stack

Overview

Creates a new stack with the specified name and configuration. A stack is a collection of servers and tools that work together for your specific use case.

Endpoint

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

Authentication

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

Authorization: Bearer YOUR_API_KEY

Request Body

string

required

Name of the new stack. Must be unique within your account.

object

Stack configuration settings

Show Configuration Object

boolean

default:"false"

Whether to enable analytics for this stack

Response

string

Unique identifier for the newly created stack

string

Name of the created stack

object

Stack configuration settings

Show Configuration Object

boolean

Whether analytics are enabled for this stack

array

Array of servers (empty for newly created stacks)

string

ISO timestamp when the stack was created

string

ISO timestamp when the stack was last updated

Example Request

curl -X POST "https://api.toolrouter.ai/v1/stacks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "stack_name": "My New Stack",
    "configuration": {
      "analytics_enabled": true
    }
  }'

import requests

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

data = {
    "stack_name": "My New Stack",
    "configuration": {
        "analytics_enabled": True
    }
}

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

stack = response.json()

const response = await fetch('https://api.toolrouter.ai/v1/stacks', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    stack_name: "My New Stack",
    configuration: {
      analytics_enabled: true
    }
  })
});

const stack = await response.json();

Example Response

{
  "stack_id": "stack_456a7890-b12c-34d5-e678-426614174002",
  "stack_name": "My New Stack",
  "configuration": {
    "analytics_enabled": true
  },
  "servers": [],
  "created_at": "2024-01-25T12:30:00Z",
  "updated_at": "2024-01-25T12:30:00Z"
}

Minimal Request Example

You can create a stack with just a name, and default configuration will be applied:

curl -X POST "https://api.toolrouter.ai/v1/stacks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "stack_name": "Simple Stack"
  }'

import requests

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

data = {
    "stack_name": "Simple Stack"
}

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

stack = response.json()

Error Responses

Invalid request data

{
  "detail": "Stack name is required"
}

Invalid or missing API key

{
  "detail": "Unauthorized"
}

Rate limit exceeded

{
  "detail": "Too many requests"
}

Server error occurred

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

API Documentation

Stack Specific Endpoints

Account Management API

Stack Management

Server Management

Credentials Management

Tools Management

SDK

Overview

Endpoint

Authentication

Request Body

Response

Example Request

Example Response

Minimal Request Example

Error Responses

​Overview

​Endpoint

​Authentication

​Request Body

​Response

​Example Request

​Example Response

​Minimal Request Example

​Error Responses

Overview

Endpoint

Authentication

Request Body

Response

Example Request

Example Response

Minimal Request Example

Error Responses