Orqen Docs

API Reference

API Reference

Base URL: https://api.orqen.app

Use your Orqen API key in the Authorization header for both chat completions and account APIs: Authorization: Bearer sk-orq-YOUR_KEY. The browser dashboard may use a session internally, but scripts and agents should use Orqen API keys.

Chat

POST
/v1/chat/completions

Send a chat completion request with automatic tool pruning

Account

GET
/v1/account/me

Return the current account profile

DELETE
/v1/account/me

Permanently delete the current account and associated data

POST
/v1/account/register

Dashboard signup provisioning endpoint

API Keys

GET
/v1/account/keys

List all API keys for your account

POST
/v1/account/keys

Create a new API key

DELETE
/v1/account/keys/{key_id}

Revoke an API key

GET
/v1/keys

Short alias for listing API keys

POST
/v1/keys

Short alias for creating API keys

DELETE
/v1/keys/{key_id}

Short alias for revoking API keys

Providers

GET
/v1/account/providers

List connected provider keys

PUT
/v1/account/providers

Add or update a provider key

DELETE
/v1/account/providers/{provider}

Remove a provider key

Model routing

GET
/v1/account/routing/preferences

Get routing mode and preferences

PUT
/v1/account/routing/preferences

Update routing mode

GET
/v1/account/routing/models

List models available from connected providers

GET
/v1/account/routing/models/status

Available models with enabled state and performance data

POST
/v1/account/routing/models/toggle

Enable or disable a model for automatic routing

GET
/v1/account/routing/insights

Best recall, fastest, and most-used routing insights

GET
/v1/account/routing/calibration

Measured K policy and recall calibration buckets

GET
/v1/account/routing/traces

Recent routing decisions with intent, K reason, and top candidates

Usage, requests, and billing

GET
/v1/account/usage/summary

Current month token savings, cost, and provider savings

GET
/v1/account/usage/daily

Daily token savings for the last 30 days

GET
/v1/account/requests

Request log (paginated)

GET
/v1/account/requests/{request_id}

Detailed request log entry

GET
/v1/account/billing

Subscription tier and projected charge

GET
/v1/usage/summary

Short alias for current month usage

GET
/v1/usage/daily

Short alias for daily usage

GET
/v1/requests

Short alias for recent requests

Tool health

GET
/v1/account/tools/health

Description quality and routing accuracy per tool

GET
/v1/account/tools/recall-alerts

Tools that were needed but missing from pruned sets

GET
/v1/account/tools/suggestions

Description and example suggestions from hard-negative collisions

Common response headers

x-orqen-tools-inputNumber of tools in the original request
x-orqen-tools-outputNumber of tools forwarded to the LLM
x-orqen-prune-ratiooutput/input (e.g. 8/32)
x-orqen-routingRouting method: semantic | keyword | none
X-Request-IDUnique request ID for tracing