GEgetsales
signal_preferences

Update signal preferences

Change your own Signals page settings, a partial update: each field sent replaces the stored value. hidden_types and notify_types are whole lists of signal types: to stop or start hearing of one, read the row and send the list without or with it. sender_profile_scope all | mine | chosen, with sender_profile_sids for chosen; toast_enabled; saved_views, the whole list: stored views keep their ids, a new one gets one. seen_at is mark_signals_seen. Nothing editable is 422 nothing_to_update.

Contract:

  • MCP tool update_signal_preferences, registry package mcp.signals/signal_preferences, mount signals.website.
  • Operation update, response envelope update.
  • Flags: none.
patch/api/signal-preferences

Request

  • Base URL
    https://beta.getsales.io/signals/v1
  • Auth
    HTTP bearer and API key in header Team-SID

Request body

hidden_typesstring[]

The signal types the feed leaves out. Replaces the stored list as a set ([] shows every type); duplicates collapse, stored in the page's order.

notify_typesstring[]

The signal types the user is told about (the badge and the toast). Replaces the stored list as a set ([] tells nothing): to add or drop one type, read the row and send the whole list.

sender_profile_scope'all' | 'mine' | 'chosen'

all | mine | chosen: whose sender profiles the feed starts on. Moving off chosen keeps sender_profile_sids.

sender_profile_sidsstring[]

The chosen sender profiles (unibox sender profile sids, ub_sp_..., 18 characters), at most 200; duplicates collapse. Read when sender_profile_scope is chosen, where [] means every sender profile.

toast_enabledboolean

false stops the toasts; the badge still counts.

Response

update success envelope.

successtrue required
operation'update' required
updated_fieldsstring[] required
previous_valuesobject required
kept_fieldsstring[]

The fields this write did not change because the person's own value stands on them (stamped person); read the item for what landed.

Changes

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