ClearRun limits and errors

Length limits, rate limits, and the errors the API returns.

Last updated November 9, 2026

Start here

ClearRun limits
Score, evaluate and chat accept 10 to 100,000 characters. Over the rate limit returns HTTP 429. Then wait and retry.
Common ClearRun errors
ClearRun errors are JSON with a message and an optional code. This page lists the common HTTP statuses and what to do. Fix the request or the key, then retry.

All Limits and errors articles

ClearRun limits
Score, evaluate and chat accept 10 to 100,000 characters. Over the rate limit returns HTTP 429. Then wait and retry.
Common ClearRun errors
ClearRun errors are JSON with a message and an optional code. This page lists the common HTTP statuses and what to do. Fix the request or the key, then retry.
Why am I getting 401 'Missing Authorization: Bearer <apiKey>'?
ClearRun returns 401 Missing Authorization when a request has no API key. Add the header Authorization: Bearer with your key, then send it again. More inside.
Why am I getting 401 'Unauthorized'?
ClearRun didn't recognize the key. It may be mistyped, cut short, or removed. Copy the key again or create a new one. Read more in the ClearRun help center.
Why am I getting 402 'Insufficient credits'?
Your balance can't cover the call, so ClearRun refused it. Nothing was scored or charged. The reply includes creditsNeeded and currentBalance. ClearRun help.
Why am I getting 403 'API access requires a Pro plan or higher'?
This 403, code API_ACCESS_REQUIRED, means the key is not a free developer key. A verified free account can create one developer key.
Why am I getting 403 WORKSPACE_FORBIDDEN?
ClearRun returns 403 WORKSPACE_FORBIDDEN when the workspaceId you sent is not on your account. Use your own workspace id from a receipt, or leave the field out.
Why am I getting 403 AUDIT_LEVEL?
The workspace's audit level does not allow export. The message is Workspace audit level does not allow export. A plain answer from the ClearRun help center.
Why am I getting 404 'verdict not found'?
ClearRun has no saved receipt for that id. Check the id. If you just scored it and the receipt was queued, try again in a few minutes. ClearRun help center.
Why am I getting 429 'Rate limit exceeded'?
You sent more calls than your plan allows in a minute, hour or day. Wait the number of seconds in the Retry-After header, then try again. ClearRun help center.
Why am I getting 400 'responseText is required'?
The request body had no responseText. Send the text to score in a field named exactly responseText, as JSON. A plain answer from the ClearRun help center.
Why am I getting 400 'Message required'?
ClearRun chat returns 400 Message required when the request has no message or it is empty. Send JSON with a message field. To score text, use responseText.
Why am I getting 400 'Content too short to evaluate meaningfully'?
Under 10 characters, ClearRun returns 400 CONTENT_TOO_SHORT: Content is too short to score on evaluate, and similar messages on score and chat. Send full text.
Why am I getting 400 CONTENT_TOO_LONG?
The text is over 100,000 characters, the limit for score, evaluate and chat. The reply includes maxLength (100000) and actualLength. Shorten it or split it.
Why am I getting 400 MESSAGE_TOO_LONG?
ClearRun chat no longer returns MESSAGE_TOO_LONG. A message over 100,000 characters gets 400 Message too long with code CONTENT_TOO_LONG. How to fix it.
Why am I getting 400 'Request blocked'?
Blocked content on ClearRun score, evaluate and chat returns 400 Content blocked with code CONTENT_BLOCKED. Request blocked means something else. Fixes inside.
Why am I getting 500 UNSIGNED_VERDICT?
ClearRun could not sign the verdict, so it returned an error instead of an unsigned score. The message is Verdict was not signed. Retry. ClearRun help center.
Why am I getting 503 PERSIST_FAILED?
ClearRun could not save the receipt or queue it for a retry, so it rejected the call. You were not charged. Retry after a short wait. ClearRun help center.
What are ClearRun's chat rate limits?
On paid plans, chat is counted separately from scoring. Pro allows 30 a minute, 300 an hour and 2,000 a day. A free developer key has a shared cap.

Start here

All Limits and errors articles

Other topics