API Playground

Try the API

Use the playground below to explore and test AssistantRouter's API endpoints.

Base URL

https://api.assistantrouter.com/v1

Authentication

All requests require an API key. Include it in the Authorization header:

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

API keys can be created in your dashboard under Settings > API Keys.

Endpoints Overview

Chat Completions

POST /v1/chat/completions

Create a chat completion using a pre-configured assistant.

curl -X POST https://api.assistantrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "assistant_id": "your-assistant-uuid",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

Models

GET /v1/models

List all available models.

curl https://api.assistantrouter.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

Conversations

GET /v1/conversations

List all conversations.

POST /v1/conversations

Create a new conversation.

GET /v1/conversations/:id

Get a specific conversation with messages.

GET /v1/conversations/search

Search conversations with full-text search.

GET /v1/conversations/stats

Get aggregated conversation statistics.

Usage

GET /v1/usage

Get usage statistics for your workspace.

GET /v1/usage/recent

Get recent usage records.

GET /v1/usage/daily

Get daily usage breakdown.

Wallet

GET /v1/wallet

Get your wallet balance.

GET /v1/wallet/transactions

Get transaction history.

Limits

GET /v1/limits

Get your workspace limits and current usage.

GET /v1/limits/tiers

Get all tier definitions.

OpenAPI Specification

The full OpenAPI specification is available at:

• Swagger UI: https://api.assistantrouter.com/docs

You can import this specification into tools like:

• Postman - Import from URL
• Insomnia - Create from URL
• Swagger UI - Load spec from URL
• API clients - Generate SDKs