That Is A Q API

Build intelligent query workflows, extract structured insights, and integrate Q's reasoning engine into your applications. RESTful, JSON-native, and designed for scale.

# Send a query to the Q engine
curl https://api.thatisaq.com/v1/questions \
  -H "Authorization: Bearer YOUR_Q_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Summarize Q3 revenue trends",
    "context_id": "ctx_8x9a2b",
    "mode": "analytical"
  }'
                    

const q = require('that-is-a-q');

const client = new q.Client({ apiKey: process.env.Q_API_KEY });

const response = await client.questions.create({
  query: "Summarize Q3 revenue trends",
  context_id: "ctx_8x9a2b",
  mode: "analytical"
});

console.log(response.data.insight);
                    

import that_is_a_q as q

client = q.Client(api_key="YOUR_Q_API_KEY")

response = client.questions.create(
    query="Summarize Q3 revenue trends",
    context_id="ctx_8x9a2b",
    mode="analytical"
)

print(response["insight"])
                    

Authentication

The Q API uses Bearer tokens for authentication. Include your API key in the `Authorization` header. Never expose your secret key in client-side code.

Authorization: Bearer q_live_7x92k3m4p5q6r7s8t9u0
# or alternatively:
X-Q-Key: q_live_7x92k3m4p5q6r7s8t9u0

Core Endpoints

All requests are routed through `https://api.thatisaq.com/v1/`. Responses are returned as JSON with standard HTTP status codes.

POST /v1/questions Submit a new query to the reasoning engine

GET /v1/questions/:id Retrieve query result, processing status, and metadata

POST /v1/contexts Create a knowledge context window for scoped queries

PUT /v1/contexts/:id Update context parameters and source bindings

DELETE /v1/webhooks/:id Remove a configured event listener

Response Example

{
  "id": "q_3f8a9b2c1d,
  "status": "completed,
  "query": "Summarize Q3 revenue trends,
  "insight": "Q3 revenue increased by 14.2% YoY, driven primarily by enterprise tier upgrades...,
  "confidence": 0.94,
  "latency_ms": 230,
  "sources": [
    "db://finance/reports_2024,
    "doc://strategy/q3_review
  ],
  "created_at": "2025-10-24T14:32:01Z
}

Rate Limits & System Status

The Q API is engineered for high availability. Monitor your usage and stay informed about system performance.

System Status

All systems operational. Global latency averaging 140ms across 9 regions.

Rate Limits

Standard: 120 requests/min
Pro: 600 requests/min
Enterprise: Custom scaling

Timeout & Retries

Default timeout: 30s. Use `idempotency_key` for safe retries on POST endpoints.

Webhooks

Subscribe to `query.completed`, `context.updated`, and `rate_limit.warned` events.