GEgetsales
conversations

Link conversation person

Attach one participant of this thread to an EXISTING playtables person. Exact identifier matches already auto-link at ingest, so this is the manual or agent-proposed path, and a fuzzy match is always a suggestion a human confirms. Linking the primary counterpart sets primary_person_sid, hands the thread the person's orchestration features, and returns merge_candidate_sids: the other live threads that already point at the same person. People are created with the playtables tools, never here.

Contract:

  • MCP tool link_conversation_person, registry package mcp.unibox/conversations, mount unibox.threads.
  • Operation action, response envelope action.
  • Flags: none.
post/api/conversations/{sid}/link-person

Request

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

Path parameters

sidstring required

Conversation sid (ub_cv_...).

Request body

participant_sidstring required

The participant to link. It must belong to THIS thread, else 422 validation_failed on participant_sid.

person_sidstring required

An EXISTING playtables person. Create the person with the playtables tools first; this verb never creates one.

Response

action success envelope.

successtrue required
operation'action' required
actionstring required

kebab-case verb; matches the route segment.

Changes

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