Reference
Errors
Error codes your agent can return, and what to do about each.
Expected failures come back as readable tool errors that your agent shows you as they are. Unexpected failures are reported to us automatically without your data.
- auth_required
- You are not signed in or your sign-in expired. The bridge starts a new device code for you.
- insufficient_credits
- Your balance is lower than the cost of the check. Top up on the Usage page, or run a cheaper mode.
- cap_reached
- A daily spending cap set by an owner is reached, for the organization or for the project. Stop and tell the user; they can raise the cap on the Usage page or wait until tomorrow (UTC).
- forbidden
- The request is not allowed, for example an API key used on a different project.
- not_found
- The project or run does not exist in your organization.
- invalid_input
- An argument is missing or malformed. The message names the field.
Sign-in errors
- authorization_pending
- Waiting for you to approve the code. Normal while you are in the browser.
- slow_down
- The agent polled too fast and backs off automatically.
- expired_token
- The code expired after 10 minutes. Start sign-in again.
- access_denied
- The code was denied on the approval page.