inbox

Update the workspace AI defaults

Partial update: only the fields you send change. labelling_enabled is the auto-label switch: off means new replies stay unlabeled. agent_replies_enabled is the workspace switch for replies the agent writes and may send on its own; turning it off stops them all at once. ai_disclosure_line is added below every email reply the agent sends on its own. Needs a signed-in person: an API key cannot change these.

patch/inbox/ai-settings/

Request

  • Base URL: https://api.getoneprofile.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.getoneprofile.ai/inbox/ai-settings/
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Request body

agent_replies_enabledboolean nullable

The workspace switch for replies the agent writes and may send on its own. Off, the agent writes no replies and nothing is sent without a person; Draft with AI in the inbox still works. Leave out to keep it as it is.

ai_disclosure_linestring nullable

A line added below every email reply the agent sends on its own, for rules that require saying a message was written with AI. Never added to a reply a person approved. Up to 300 characters. Send null to stop adding one; leave out to keep it as it is.

default_languagestring nullable
default_reply_mode'off' | 'draft_and_queue'

How far the AI reply layer may go on this sequence.

OFF is the default everywhere: a workspace opts in. DRAFT_AND_QUEUE is as far as it goes: every draft waits in Needs approval for a person, whatever its confidence. There is deliberately no mode past it. A self-sending auto-pilot shipped once and was removed under the ruling that a send cannot be taken back, so nothing may send with nobody present; rows that carried it were moved to DRAFT_AND_QUEUE by the retire_auto_send_reply_mode release task. A SENT draft with no approver is therefore always history from before that ruling.

default_tone'professional' | 'friendly' | 'direct' | 'casual'

How a generated reply should read.

labelling_enabledboolean nullable

Response

Successful Response

agent_replies_enabledboolean required

The workspace switch for replies the agent writes and may send on its own. Off, the agent writes no replies and nothing is sent without a person; Draft with AI in the inbox still works.

ai_disclosure_linestring nullable required

A line added below every email reply the agent sends on its own, for rules that require saying a message was written with AI. Never added to a reply a person approved. Null adds nothing.

default_languagestring nullable required
default_reply_mode'off' | 'draft_and_queue' required

How far the AI reply layer may go on this sequence.

OFF is the default everywhere: a workspace opts in. DRAFT_AND_QUEUE is as far as it goes: every draft waits in Needs approval for a person, whatever its confidence. There is deliberately no mode past it. A self-sending auto-pilot shipped once and was removed under the ruling that a send cannot be taken back, so nothing may send with nobody present; rows that carried it were moved to DRAFT_AND_QUEUE by the retire_auto_send_reply_mode release task. A SENT draft with no approver is therefore always history from before that ruling.

default_tone'professional' | 'friendly' | 'direct' | 'casual' required

How a generated reply should read.

labelling_enabledboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.