Orqen Docs

API Reference

Tool health

Tool health endpoints expose description quality, recall misses, and hard-negative collisions so teams can improve tool descriptions without reading raw request logs.

Endpoints

GET/v1/account/tools/healthDescription scores, issues, suggestions, and call-through stats per tool.
GET/v1/account/tools/recall-alertsTools that were called by the LLM but missing from pruned context.
GET/v1/account/tools/suggestionsSuggested description/example fixes from hard-negative collisions.

Description health

curl https://api.orqen.app/v1/account/tools/health \
  -H "Authorization: Bearer sk-orq-YOUR_KEY"

Recall alerts

A recall alert means a tool was eventually needed but was not in the pruned set.

curl https://api.orqen.app/v1/account/tools/recall-alerts \
  -H "Authorization: Bearer sk-orq-YOUR_KEY"

Suggestions

Suggestions use rejected candidates and called tools to identify collisions such asget_customer versus search_customer.

curl https://api.orqen.app/v1/account/tools/suggestions \
  -H "Authorization: Bearer sk-orq-YOUR_KEY"

Improving routing data

Tool-level function.x-orqen-examples examples are consumed by Orqen for routing and stripped before the upstream provider sees the request.