Docs

Errors

A tool error returns isError: true with the error as JSON in its text: {"error": {...}} with a code, a message, a hint, sometimes candidates or retry_after_seconds, and a docs_url to the section below. (The REST API returns the same object as the response body.)

INVALID_INPUT

A value is missing or not valid. The message starts with the field to fix.

NOT_FOUND

The object does not exist, or this key cannot see it. Search again: ids can change when mail moves.

AMBIGUOUS_ACCOUNT

A write without account_id while several accounts could do it. Read the candidates, choose one (or ask the user) and retry with account_id.

ACCOUNT_NOT_PERMITTED

The account is outside this key's reach (its account scope).

SCOPE_NOT_GRANTED

The key lacks the scope the tool needs; the message names it. The workspace owner can issue a key with it.

ACCOUNT_NEEDS_REAUTH

The owner must reconnect the account in Prubex. Tell the user; the error carries the link for them.

ACCOUNT_PAUSED

Someone paused the account, a person in Prubex or an agent with accounts_pause; agents cannot reach it until it is resumed.

ACCOUNT_SUSPENDED

The workspace's plan does not cover this account right now.

PROVIDER_UNSUPPORTED

This provider cannot do this; the message explains what it can do instead.

PROVIDER_ERROR

The provider failed. Try again shortly; if it persists, the request id helps support.

PROVIDER_RATE_LIMITED

The provider asked Prubex to slow down; wait retry_after_seconds.

RECIPIENT_BLOCKED

The account's policy blocks one or more recipients; every offending address is listed.

RECIPIENT_NOT_ALLOWED

The account only sends to an allowlist, and these recipients are not on it.

SEND_BLOCKED

The account's policy blocks sending by agents.

SEND_LIMIT_REACHED

The account reached its daily send cap (20 in a new workspace's first 24 hours), which resets at 00:00 UTC. In those first 24 hours each message or invitation also reaches at most 10 people.

POLICY_DENIED

The account's policy forbids this for agents, such as moving mail to Trash or changing folders, or a person paused the account and only a person can resume it. On Microsoft accounts it also answers an edit to a message Prubex is sending at that moment (a large send through a draft); that one clears when the send ends.