Skip to content
Browse docsget_goal_match

get_goal_match

Reads one currently listed saved match and its authorized assessment.

Annotations: readOnlyHint: true · destructiveHint: false · idempotentHint: true · openWorldHint: false

Inputs#

InputRequiredDescription
matchIdyesExact match UUID from a match collection or authorized conversation

Returns#

The match resource directly: the same id, name, route, context, fit, introduction, and ownOutreach as a match summary, plus:

FieldDescription
goalIdParent goal identity
goalOwnerNameAuthorized display name of the member who owns the goal, or null
viewerRolegoal_owner or connector
beneficiary{ personId, name } for an owned goal for someone else, otherwise null
assessedGoalTextWording this assessment used; an earlier assessment is not reassessed for edited wording
publicIdentityNullable headline, currentRole, and linkedInUrl from the safe LinkedIn projection; own-contact profiles use the separate person read
assessmentNullable object with summary, howTheyCouldHelp, whatTheBeneficiaryCouldOffer, valueToBeneficiary, and valueToCandidate
memberSuppliedReasonThe member's reason for suggesting this person, or null; it is not a model assessment
offeredToBeneficiaryWhether the goal owner already offered this own contact to the beneficiary

Strengths are borderline_yes, clear_yes, strong_yes, or null. They refer to the named beneficiary, otherwise the goal owner. A hand-added match has its member's reason and a null assessment. A personal offer originating from a search can retain coarse strengths without private assessment prose.

For route.kind: "own_contact", use its personId with get_person for your own contact's profile and relationship context. Through-member requester views contain only the safe name, selected public LinkedIn fields, requester-safe explanation, and coarse strengths. They never carry the other owner's person ID, contact details, relationship context, or private evidence. Connector reads concern their own contacts; MCP adds no connector collection discovery.

Missing, inaccessible, unlisted, and ended-goal matches return unavailable. This Get does not read archived match history. Nothing is refreshed, chosen, approved, or sent. A match establishes neither willingness nor a successful introduction. Open the returned goal link to discuss or act in Gravity.

Example#

json
{
  "matchId": "00000000-0000-4000-a000-000000000002"
}

Result (synthetic data):

json
{
  "id": "00000000-0000-4000-a000-000000000002",
  "name": "Synthetic candidate",
  "route": { "kind": "through_member", "connector": { "memberId": "00000000-0000-4000-a000-000000000003", "name": "Synthetic connector" } },
  "context": "current",
  "fit": "potential_win_win",
  "introduction": "not_requested",
  "ownOutreach": null,
  "goalId": "00000000-0000-4000-a000-000000000001",
  "goalOwnerName": "Synthetic requester",
  "viewerRole": "goal_owner",
  "beneficiary": null,
  "assessedGoalText": "Find design partners",
  "publicIdentity": { "headline": "Public headline", "currentRole": "Public role", "linkedInUrl": null },
  "assessment": { "summary": "Possible design partner", "howTheyCouldHelp": "Could discuss the product", "whatTheBeneficiaryCouldOffer": "Product feedback", "valueToBeneficiary": "clear_yes", "valueToCandidate": "borderline_yes" },
  "memberSuppliedReason": null,
  "offeredToBeneficiary": false
}