Errors
A refusal comes back as a tool result withisError: true and a JSON object:
error names the case and detail is a sentence you can show the user. The
object is always in the result’s text. A tool that declares an output schema
sends it only there, with no structuredContent, because a refusal does not
match that schema. Switch on error:
Other codes can appear. Always show
detail.
A credit or plan refusal says the same thing every time and points to the
dashboard, where the user manages their plan and credits. It carries no
payment link:
create_business, a first_pass with a credit or plan error has
the same shape.
Limits
- The per-business limits in Rate limits apply to calls made through a connected AI agent too, on the same counters as the business’s own agents.
- Tool results over 1 MB are refused with
too_large: narrow the request. upload_filetakes files up to 3 MB. Larger files go through the Files panel of the business dashboard.