NeuronLens
Browse the documentation
Start

Limits and usage

The daily allowance for each API, what counts as a run, and how to see what is left.


The daily allowance

Agent LensAgent Lens playground APIIntegrity Lens
Endpoints/v1/score and the integrations (/v1/pre-action, /v1/traces, /aegis/*)/v1/agent/*/v1/integrity/* and the web app
Runs per day1,0001010
What is one runOne scored answer or agent step (POST /v1/score, POST /v1/pre-action, POST /aegis/post-action), or one POST /v1/traces batchOne POST /v1/agent/scoreOne scan: POST /v1/integrity/scans, a scan started in the web app, or a new POST /v1/integrity/scan
Requests per minute3001010
Resets00:00 UTC00:00 UTC00:00 UTC

The allowance belongs to your account, not to a key: all your keys share it, and creating a new key does not reset it.

What does not count

  • Anything that fails: an error, a timeout, "busy", the service being offline.
  • With the one-call POST /v1/integrity/scan: results that were already stored (the same model revision, scanned before by anyone, comes back at once with "cached": true), and models outside the supported families (they come back Unknown without a scan).
  • Read-only calls: /v1/me, /v1/health, /v1/probes, /v1/decisions/{id}, /v1/requests, /v1/runs, and every Integrity Lens GET (scans, models, reports, sources, families).
  • Labels (POST /v1/labels) and the console's Why was this flagged? re-reads.

Seeing what is left

  • Every run answers with two headers: X-Quota-Limit and X-Quota-Remaining.
  • GET /v1/me returns today's usage for each product (agent-lens-app is the Agent Lens API above) (see Account).
  • Profile → API keys on neuronlens.com shows the same.

When the allowance is used up

The API answers 429 with "error": "daily_limit", the time it resets, and where to ask for more:

{
  "error": "daily_limit",
  "detail": "You have used today's 1000 Agent Lens runs. They reset at 00:00 UTC.",
  "limit": 1000,
  "resets_at": "2026-10-13T00:00:00Z",
  "upgrade_url": "https://neuronlens.com/about",
  "request_id": "req_9bc51e9e6bd6"
}

Need more for an evaluation or a pilot? Contact us.

Other limits

LimitValue
Requests per minute, per account300 for Agent Lens, 10 for the others (429 rate_limited with Retry-After)
Request body2 MB for /v1/score, /v1/pre-action, /v1/post-action, /v1/traces and /aegis/*; 64 KB for the rest
Agent Lens time per callabout 0.5–2 s
Integrity Lens time per scanabout 30–60 s for a new model; instant when stored