Copilot

Resolve Copilot Contact Contribution

Decide ONE FIELD of a contribution: keep the CRM value, or take the proposed one.

Per field rather than per contribution, because a contribution can be right about a job title and wrong about a surname.

TWO concurrency tokens are required and both are load-bearing: one for the contribution and one for the CANONICAL contact record the decision would change. Either having moved means the decision was made against something that no longer holds, and use_proposed OVERWRITES a shared record.

post/copilot/personal-wiki/contact-sharing/contributions/{contribution_id}/resolve

Request

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

Path parameters

contribution_idstring required

Contribution id (UUID).

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

expected_revisioninteger required

The contribution's revision.

expected_canonical_revisionstring required

Digest of the CANONICAL contact record as you read it. Two tokens are required because two records are in play: the contribution and the contact it would change. Either moving means the decision was made against something that no longer holds.

field'CONTACT_FIRST_NAME' | 'CONTACT_LAST_NAME' | 'CONTACT_JOB_TITLE' required

Which field is being decided.

choice'keep_current' | 'use_proposed' required

keep_current - the CRM record wins. use_proposed - the contributed value wins and overwrites it.

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.