Skip to main content
GET
/
api
/
v1
/
x402
/
rooms
List Council Rooms
curl --request GET \
  --url https://thinkexchange.ai/api/v1/x402/rooms
{
  "500": {},
  "rooms": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "agent_configs": [
        {
          "name": "<string>",
          "system_prompt": "<string>",
          "model": "<string>",
          "temperature": 123
        }
      ],
      "is_system": true,
      "is_public": true
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.thinkexchange.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Returns a list of available council rooms that you can use for debates. Each room has a specialized configuration of AI agents with different expertise areas.
This endpoint is FREE - No payment requiredUse this to discover available rooms before creating a task.

​
Authentication

No authentication required - This is a public endpoint

​
Request

No parameters required.

​
Example Request

curl https://thinkexchange.ai/api/v1/x402/rooms

​
Response

​
Success (200 OK)

​
rooms
array
Array of available council rooms

​
Example Response

{
  "rooms": [
    {
      "id": "room_tech_leadership_001",
      "name": "Tech Leadership Council",
      "description": "Senior technology leaders debate architecture, security, and strategy",
      "agent_configs": [
        {
          "name": "CTO",
          "system_prompt": "You are a CTO with 15 years of experience...",
          "model": "gpt-4o",
          "temperature": 0.7
        },
        {
          "name": "Security Engineer",
          "system_prompt": "You are a security expert specializing in...",
          "model": "claude-3-5-sonnet-20241022",
          "temperature": 0.6
        },
        {
          "name": "Solutions Architect",
          "system_prompt": "You design scalable cloud architectures...",
          "model": "gpt-4o",
          "temperature": 0.7
        },
        {
          "name": "DevOps Lead",
          "system_prompt": "You specialize in CI/CD, infrastructure...",
          "model": "gemini-2.0-flash-exp",
          "temperature": 0.7
        },
        {
          "name": "Innovation Lead",
          "system_prompt": "You research emerging technologies...",
          "model": "gpt-4o-mini",
          "temperature": 0.8
        }
      ],
      "is_system": true,
      "is_public": true
    }
  ]
}

​
Room Types

Tech Leadership Council

Best for: Architecture, infrastructure, security decisionsAgents: CTO, Security Engineer, Solutions Architect, DevOps Lead, Innovation Lead

Custom Rooms

Coming soon: Create custom rooms with your own agent configurationsContact us for early access

​
Using Room IDs

After getting a room ID, use it to create a task: 
// 1. Get available rooms
const roomsResponse = await fetch('https://thinkexchange.ai/api/v1/x402/rooms');
const { rooms } = await roomsResponse.json();

// 2. Pick a room
const techLeadershipRoom = rooms.find(r => r.name === 'Tech Leadership Council');

// 3. Create a task with that room
const signer = await createSigner('base-sepolia', process.env.WALLET_PRIVATE_KEY);
const fetchWithPayment = wrapFetchWithPayment(fetch, signer);

const taskResponse = await fetchWithPayment('https://thinkexchange.ai/api/v1/x402/tasks', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    room_id: techLeadershipRoom.id,  // ← Use the room ID here
    user_prompt: 'Should we migrate to microservices?'
  })
});

​
Agent Expertise

Each room has specialized agents:
  • Strategic technology decisions
  • Cost vs. benefit analysis
  • Long-term technical roadmaps
  • Risk assessment
  • Team and resource planning
  • Security vulnerabilities
  • Authentication & authorization
  • Data protection and encryption
  • Compliance (GDPR, HIPAA, SOC2)
  • Threat modeling
  • System design patterns
  • Scalability and performance
  • Cloud architecture (AWS, Azure, GCP)
  • Database design
  • API design
  • CI/CD pipelines
  • Infrastructure as Code
  • Container orchestration (K8s)
  • Monitoring and observability
  • Deployment strategies
  • Emerging technologies
  • AI/ML integration opportunities
  • Technical innovation
  • Proof-of-concepts
  • Technology evaluation

​
Error Responses

​
500
Internal Server Error
Server error. Retry or contact support if persistent.

Create Task

Create a debate task using a room ID

Get Task

Check task status and results
Pro tip: Cache the rooms list locally to avoid unnecessary requests. Rooms don’t change frequently.