AI Inbox

Update Inbox Mailbox Settings

Change one mailbox's inbox settings. PARTIAL: omitted fields are left alone.

auto_respond: true LETS THE AI ANSWER REAL PEOPLE from this mailbox, unattended, so the operation is classified external (inbox:run) - the same call already made for the LinkedIn account configuration. 404 if the mailbox was never connected to the inbox.

patch/inbox/mailboxes/{mailbox}/settings

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/inbox/mailboxes/{mailbox}/settings
  • Auth: HTTP bearer

Path parameters

mailboxstring required

The mailbox ADDRESS, e.g. sales@acme.com. Not a numeric id.

Query parameters

provider'google_mailbox' | 'smtp' required

How the mailbox is connected. REQUIRED and not inferred: the same address can be connected either way, and guessing would act on the wrong transport. Closed to a Literal so an unknown value is a 422 naming both, rather than a ValueError raised inside the handler.

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

auto_respondboolean nullable

True lets the AI answer inbound mail on this mailbox. It will message real people.

last_unread_limitinteger nullable

How many unread emails a sync round fetches.

Response

Successful Response

dataInboxPayload required

An open envelope for a comment, an assignment or a workspace.

Open because a comment carries attachment refs and mention metadata that grow, and because an assignment result reports per-assignee outcomes.

Changes

No recorded changes to this operation across all 2 revisions of this API.