DualMind Lab API

The DualMind Lab API provides programmatic access to the blind AI model comparison arena. Send prompts, manage threads, vote on responses, and access model statistics.

Base URL: https://api.dualmindlab.techAll endpoints are prefixed with /api/.

Authentication

Most endpoints require a in the Authorization header:

Authorization: Bearer <your_jwt_token>

Tokens are issued by Supabase Auth and expire after 1 hour. Use supabase.auth.refreshSession() to renew.

Quick start

Get your JWT token

JavaScript
cURL
Python

import { createClient } from '@supabase/supabase-js';

const supabase = createClient(SUPABASE_URL, SUPABASE_ANON_KEY);
const { data } = await supabase.auth.signInWithPassword({
  email: 'user@example.com',
  password: 'your-password'
});
const token = data.session.access_token;

# Use the token from your Supabase Auth session
export TOKEN="your_jwt_token_here"

from supabase import create_client

supabase = create_client(SUPABASE_URL, SUPABASE_ANON_KEY)
response = supabase.auth.sign_in_with_password({
    "email": "user@example.com",
    "password": "your-password"
})
token = response.session.access_token

Create a thread

curl -X POST https://api.dualmindlab.tech/api/arena/thread/new \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "My first comparison"}'

Send a message

curl -X POST https://api.dualmindlab.tech/api/arena/send \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Explain quantum computing in simple terms",
    "threadId": "your-thread-id"
  }'

You’ll receive two anonymized model responses for blind comparison.

Vote on the best response

curl -X POST https://api.dualmindlab.tech/api/arena/vote \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "comparisonId": "comparison-uuid",
    "winner": "model_a"
  }'

Endpoint categories

Chat & Arena

Send messages in single or dual (arena) mode with blind model comparison

Threads

Create, list, update, share, and delete conversation threads

Voting & Stats

Submit votes and retrieve model leaderboard statistics

Models & Users

List available AI models and sync user profiles

Utilities

Health checks, feature flags, and text-to-speech

Admin API

Full CRUD operations for platform management

Response format

All API responses use JSON. Successful responses return the data directly. Errors follow a consistent format:

Success
Error

{
  "responses": [
    {
      "model": "Model A",
      "content": "Quantum computing uses qubits...",
      "latencyMs": 1234
    },
    {
      "model": "Model B",
      "content": "Think of quantum computing as...",
      "latencyMs": 987
    }
  ],
  "threadId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "isArena": true
}

{
  "error": "UNAUTHORIZED",
  "message": "Invalid or expired token"
}

Error codes

HTTP Status	Error Code	Description
`400`	`INVALID_REQUEST`	Missing or invalid request parameters
`401`	`UNAUTHORIZED`	Missing, invalid, or expired JWT token
`403`	`FORBIDDEN`	Insufficient permissions (admin endpoints)
`404`	`NOT_FOUND`	Resource does not exist
`429`	`RATE_LIMITED`	Too many requests
`500`	`API_ERROR`	Internal server or AI provider error

Rate limits

Rate limits vary by endpoint and authentication status. Authenticated users receive higher limits than anonymous requests.

Endpoint Category	Authenticated	Anonymous
Chat & Arena	60 req/min	N/A
Threads	120 req/min	30 req/min (read-only)
Voting	30 req/min	N/A
Admin	120 req/min	N/A

Interactive playground

Every API endpoint page includes an interactive playground where you can test requests directly in the browser. Enter your JWT token and try the API without writing any code.

Overview

Chat & Arena

Threads

Voting & Stats

Models & Users

Utilities

Admin API

API Reference

DualMind Lab API

Authentication

Quick start

Endpoint categories

Chat & Arena

Threads

Voting & Stats

Models & Users

Utilities

Admin API

Response format

Error codes

Rate limits

Interactive playground

SDKs and tools

OpenAPI Spec

MCP Server

​DualMind Lab API

​Authentication

​Quick start

​Endpoint categories

Chat & Arena

Threads

Voting & Stats

Models & Users

Utilities

Admin API

​Response format

​Error codes

​Rate limits

​Interactive playground

​SDKs and tools

OpenAPI Spec

MCP Server

DualMind Lab API

Authentication

Quick start

Endpoint categories

Response format

Error codes

Rate limits

Interactive playground

SDKs and tools