Copilot

Update Copilot Contact Sharing

Turn contact sharing on or off for ONE mailbox.

The switch that decides whether a person's private contact knowledge starts producing contributions at all. expected_revision is required.

put/copilot/personal-wiki/contact-sharing/{mailbox_id}

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/copilot/personal-wiki/contact-sharing/{mailbox_id}
  • Auth: HTTP bearer

Path parameters

mailbox_idinteger required

Integer mailboxes.id - the database primary key, not the cron-job string id.

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

enabledboolean required

Whether what this mailbox knows about a contact is contributed to the organisation's shared CRM record. Explicit rather than a toggle, so a retry is idempotent instead of switching it back.

expected_revisioninteger required

REQUIRED optimistic-concurrency token. Sharing settings decide whether one person's private contact knowledge becomes org-wide, so there is no unconditional write: a blind one could re-enable sharing somebody had just turned off.

Response

Successful Response

dataCopilotMemoryPayload required

An open envelope for one memory, wiki or sharing answer.

Open because the personal wiki is a DOCUMENT whose sections follow what has been learned about a person, and because each fact carries provenance - which mailbox or meeting it came from - that grows as new sources are connected. Pinning the shape would silently drop the provenance on the newest source, and on a "what do you know about me" surface a fact with no visible origin is worse than no fact.

Changes

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