Skip to main content

Errors

A refusal comes back as a tool result with isError: 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:
Inside 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_file takes files up to 3 MB. Larger files go through the Files panel of the business dashboard.