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.