Relationship Intelligence

Approve

Approve accepts this proposed conversation change. The company and its review queue refresh.

post/v1/relationships/{relationshipId}/conversation-decisions

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /v1/relationships/{relationshipId}/conversation-decisions
  • Auth: HTTP bearer

Path parameters

relationshipIdstring uuid required

Relationship id.

Example:9c8dfa9b-a7b2-46ea-982c-622a914c00e5

Request body

correctedValuestring

Required replacement for correct.

deferUntilstring date-time

Future reminder for defer.

kind'approve' | 'correct' | 'reject' | 'defer' required

Decision kind.

reasonstring

Decision reason.

reviewItemIdstring required

Review item id.

Example request

{
  "correctedValue": "Security review is complete.",
  "deferUntil": "2026-08-01T14:00:00Z",
  "kind": "approve",
  "reason": "User decided a proposed conversation change.",
  "reviewItemId": "review:9abf3ca4a5e5eff1"
}

Response

The proposed change is accepted, and the review queue is refreshed.

Example response

{
  "intelligence": {
    "claims": [
      {
        "captureCaveats": [
          "Remote channel may contain multiple speakers."
        ],
        "confidence": 0.72,
        "endMs": 16000,
        "exactQuote": "We are concerned security could delay the renewal.",
        "id": "claim-risk",
        "kind": "risk",
        "material": true,
        "observationId": "6b8dfa9b-a7b2-46ea-982c-622a914c00e5",
        "speakerConfidence": 0.55,
        "speakerId": "anonymous:remote-channel",
        "speakerLabel": "Other",
        "startMs": 12000,
        "stateDimension": "risk",
        "value": "Security review may delay renewal."
      }
    ],
    "deletionReceipts": [
      {
        "completedAt": "2026-07-31T14:01:00Z",
        "receiptId": "eb8dfa9b-a7b2-46ea-982c-622a914c00e5",
        "requestedAt": "2026-07-31T14:00:00Z",
        "scopeRef": "9c8dfa9b-a7b2-46ea-982c-622a914c00e5",
        "status": "active",
        "targets": [
          {
            "attempts": 1,
            "errorCode": "legal_hold",
            "status": "deleted",
            "target": "api_evidence",
            "verificationHash": "sha256:5c15791fbeefd579cf530b240c1a3d5eec1d94058e045c8a4eadf0d1385ebfbf"
          }
        ]
      }
    ],
    "delta": {
      "changes": [
        {
          "after": "needs_attention",
          "assertionIds": [
            "6b8dfa9b-a7b2-46ea-982c-622a914c00e5"
          ],
          "before": "healthy",
          "dimension": "health",
          "reason": "Champion engagement declined after pricing."
        }
      ],
      "contradictions": [],
      "fromVersion": 0,
      "toVersion": 1,
      "uncertainClaimIds": []
    },
    "effectivePolicy": {
      "capture": "require_consent",
      "externalShare": true,
      "modelRoute": "hosted_allowed",
      "policyVersion": "policy:9373cc30008dcb712c236fc9",
      "publishEvidence": true,
      "redactionClasses": [
        "personal_identifier"
      ],
      "resolvedAt": "2026-07-31T14:00:00Z",
      "retentionDays": 30,
      "sourceLayerIds": [
        "builtin:conversation-policy-v1"
      ]
    },
    "governanceReceipts": [
      {
        "capturePolicy": "manual_capture",
        "capturedAt": "2026-07-31T14:00:00Z",
        "deletionOutcome": "scheduled_after_transcription",
        "evidenceClip": "not_retained",
        "participantDisclosure": "not_recorded",
        "receiptId": "governance:session-42:2026-07-31T14:00:00Z",
        "region": "local_device",
        "retention": "untilTranscribed",
        "routing": "local_transcription_to_oppulence"
      }
    ],
    "liveCues": [
      {
        "detail": "Agree on an owner and a dated next step before the meeting ends.",
        "id": "missing-next:9c8dfa9b-a7b2-46ea-982c-622a914c00e5",
        "kind": "missing_next_step",
        "severity": "attention",
        "title": "No next step"
      }
    ],
    "observationPageHasMore": true,
    "reviewItems": [
      {
        "baselineVersion": 4,
        "batchId": "review:8aafa89c553bd3f9b65e0bee",
        "caveats": [
          "Speaker assignment requires review."
        ],
        "claimId": "claim-risk",
        "confidence": 0.55,
        "currentValue": "Other",
        "dependentActionIds": [
          "action:ab12"
        ],
        "exactQuote": "We are concerned.",
        "id": "review:9abf3ca4a5e5eff1",
        "kind": "speaker",
        "label": "Resolve the speaker for a material statement.",
        "observationId": "6b8dfa9b-a7b2-46ea-982c-622a914c00e5",
        "stateDimension": "risk",
        "status": "active"
      }
    ]
  },
  "relationship": {
    "accountDomain": "example.com",
    "categories": [
      "Artificial intelligence"
    ],
    "commitmentCount": 4,
    "companyDescription": "Builds AI infrastructure for customer operations.",
    "companyEnrichedAt": "2026-09-06T08:00:00Z",
    "companyEnrichmentData": {
      "employee_range": "201-500 employees (2026)",
      "funding_summary": "$80M total; Series C, $35M, 2025-10-10",
      "growth_signals": "Hiring in 2026",
      "headquarters": "San Francisco, California, United States",
      "revenue_range": "$40M-$60M (2025)"
    },
    "displayName": "Jordan Buyer",
    "emailThreadCount": 12,
    "engagement": "declining",
    "health": "needs_attention",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "kind": "person",
    "lastChangedAt": "2026-07-25T16:00:00Z",
    "lastTouchAt": "2026-04-10T15:00:00Z",
    "lifecycle": "evaluation",
    "linkedinUrl": "https://www.linkedin.com/company/acme",
    "milestones": [
      "Proposal shared."
    ],
    "nextAction": "Confirm the security review owner.",
    "nextActionAt": "2026-07-01T00:00:00Z",
    "openActions": 1,
    "peopleCount": 3,
    "primaryEmail": "buyer@example.com",
    "projectedAt": "2026-07-25T16:00:00Z",
    "projectorVersion": 2,
    "resourceRefs": [
      "hubspot:company:123"
    ],
    "risks": [
      "Security review has no owner."
    ],
    "sentiment": "mixed",
    "stateHash": "sha256:454f195e2389d36fd49e5c9b9656b7b47a3629332a84eb570edf3fa5248851e1",
    "stateReason": "Security review was promised, but no owner or meeting exists.",
    "stateVersion": 4,
    "status": "active",
    "summary": "Asked for pricing in April; wants a follow-up in July."
  }
}

Changes

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