message-action-policy

Set the workspace message-action policy

Replace the emoji allowlist, proactive toggles, and per-channel/hour caps. Admin only. Patricia may react ONLY with an allowlisted emoji. She adds one on her own, and answers in an existing message's thread on her own, unless this workspace turns those toggles off; she only starts a NEW top-level message on her own if this workspace turns that one on. Every cap is the most a channel may receive in an hour, counting both the ones she is asked for and the ones she does on her own. For REACTIONS and REPLIES the unprompted ones stop short of the cap, keeping a slice back so a directed request still has room, and at a cap of 1 the unprompted lane gets none. New top-level messages have no such split: unprompted ones can use the whole cap, so at a cap of 1 an unprompted post can take the only slot. This REPLACES the whole policy, so EVERY POLICY FIELD IS REQUIRED: an omitted field is a 422 naming it, never a silent write of some default. Read the current policy with GET, change what you want, and send the whole thing back — the GET response is accepted as-is, so there is no need to strip the read-only fields it carries. One exception: an echoed stored_policy_unreadable=true is refused. That flag means the stored policy could not be read and the GET showed the fail-closed fallback, so saving it back would record the fallback as a deliberate choice and erase the only signal that anything was wrong — decide what the policy should be and send that.

put/v1/message-action-policy/tenant

Request

  • Base URL: https://api.patricia.app (the document declares no server; this is the origin it was published from)
  • URL: https://api.patricia.app/v1/message-action-policy/tenant
  • Auth: HTTP bearer

Headers

X-Tenant-Idstring nullable

Request body

stored_policy_unreadablefalse nullable
dropped_allowlist_entriesinteger nullable
enabledboolean required

Allow message actions in the workspace.

reaction_mode'all' | 'custom' required

Choose all to allow any reaction supported by Patricia's chat connection, or custom to allow only the names in reaction_allowlist.

reaction_allowliststring[] required

The emoji names Patricia may use for reactions when reaction_mode is custom. The list stays saved when reaction_mode is all.

proactive_reactions_enabledboolean required

Allow unprompted message reactions.

proactive_replies_enabledboolean required

Allow unprompted replies in message threads.

proactive_top_level_posts_enabledboolean required

Allow unprompted top-level channel messages.

max_reactions_per_channel_per_hourinteger required

The hourly reaction limit in each channel.

max_replies_per_channel_per_hourinteger required

The hourly reply limit in each channel.

max_top_level_posts_per_channel_per_hourinteger required

The hourly limit on top-level messages in each channel.

Response

Successful Response

enabledboolean required
reaction_mode'all' | 'custom' required
reaction_allowliststring[] required
proactive_reactions_enabledboolean required
proactive_replies_enabledboolean required
proactive_top_level_posts_enabledboolean required
max_reactions_per_channel_per_hourinteger required
max_replies_per_channel_per_hourinteger required
max_top_level_posts_per_channel_per_hourinteger required
stored_policy_unreadableboolean
dropped_allowlist_entriesinteger

Changes

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