RiddlerAI for developers

RiddlerAI exposes one HTTPS API for inference, vector search, model management, job dispatch and tenant administration. Everything below is what you need to call it from your own software.

Two things to know before you start

Everything goes through the Gateway. Individual services are not reachable from outside the platform — there is a single base URL, and the Gateway authenticates, rate limits and routes each request. You never address a service directly.

Every request belongs to exactly one tenant. Your credentials determine the tenant, and the Gateway sets that context server-side; you cannot select or override it with a header. This is what keeps one customer’s data out of another’s, and it is enforced all the way down to row-level security in the database.

• Quickstart

  Get a key and make your first authenticated call in a few minutes.

• Authentication

  API keys for server-to-server integrations, JWTs for user sessions.

• API reference

  Every endpoint across all services, with a console to try them.

• Streaming and grounding

  Token-by-token output, and answers drawn from your own documents.

• Errors and rate limits

  What failures look like and how to back off correctly.

• MCP server

  Connect Claude directly to your tenant’s data and models.

• SDKs

  Generated TypeScript and .NET clients.

What you can build against

Area	What it does	Base path
Inference	Chat completions, streaming, grounded answers, conversations	/api/llm/v1
Vector search	Collections and semantic search over your own documents	/api/vectordb
Models	Which models exist, and installing them	/api/models, /api/models/catalog
Workspaces	Containers for a tenant’s data and activity	/api/os/workspaces
Jobs and nodes	Dispatching work to compute nodes	/api/nodes, /api/agents
Earnings	The ledger for completed node work	/api/earnings
Tenants and users	Administration, API keys, roles	/api/auth

Getting access

Tenants are provisioned rather than self-registered today: an administrator creates your tenant and issues you an API key. Once you have a key you can do everything else — including issuing further keys for your own environments — without going back to them.

Self-serve developer signup, where you create your own sandbox tenant, is being built. Until it ships, ask your RiddlerAI administrator for a tenant and an initial API key.