Relationship Intelligence

Review

Review records that this attention item was reviewed. It leaves the open queue.

post/v1/relationship-attention/{attentionId}/decisions

Request

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

Path parameters

attentionIdstring uuid required

Attention item id.

Example:da8dfa9b-a7b2-46ea-982c-622a914c00e5

Request body

decision'acknowledge' | 'snooze' | 'dismiss' required

Decision.

expectedVersioninteger required

Expected version.

reasonstring

Decision reason.

snoozedUntilstring date-time nullable

Bounded future wake time.

Example request

{
  "decision": "acknowledge",
  "expectedVersion": 1,
  "reason": "Reviewed from the portfolio attention queue.",
  "snoozedUntil": "2026-08-07T14:00:00Z"
}

Response

This item is reviewed and leaves the open queue.

acknowledgedAtstring date-time nullable

When this item was acknowledged. Empty until then.

acknowledgedBystring uuid nullable

User who acknowledged this item. Empty until it is acknowledged.

createdAtstring date-time required

Created time.

detectorVersioninteger required

Detector version.

dismissedAtstring date-time nullable

When this item was dismissed. Empty until then.

dismissedBystring uuid nullable

User who dismissed this item. Empty until it is dismissed.

evidenceRefsstring[] required

Evidence refs.

expiresAtstring date-time nullable

Expiry time.

explanationstring required

Readable explanation.

idstring uuid required

Stable UUID primary key.

ownerIdstring uuid

Assigned user id.

projectorVersioninteger required

Projector version.

rankFactorsobject required

Readable factor contributions.

rankScoreinteger required

Internal deterministic rank.

reasonCodestring required

Detector reason.

recommendationIdstring uuid

Recommendation id.

recommendationRevisioninteger

Recommendation revision.

relationshipIdstring uuid required

Relationship id.

relationshipNamestring required

Relationship name.

relationshipStateVersioninteger required

Relationship version evaluated.

snoozedUntilstring date-time nullable

Snooze time.

sourceRequirementsstring[] required

Fresh sources required.

stateReasonstring

Why this item was acknowledged, snoozed, or dismissed. Empty while it is still open.

Lifecycle/status slug. Subscription rows use billing states; background task runs use queued/running/succeeded/failed/stopped.

triggeringObjectRefstring required

Triggering object.

updatedAtstring date-time required

Updated time.

urgencyBand'low' | 'normal' | 'high' | 'critical' required

Urgency.

versioninteger required

Optimistic version.

Example response

{
  "createdAt": "2026-07-31T14:00:00Z",
  "detectorVersion": 1,
  "evidenceRefs": [
    "revenue-evidence:4b8dfa9b-a7b2-46ea-982c-622a914c00e5"
  ],
  "expiresAt": "2026-08-07T14:00:00Z",
  "explanation": "A confirmed promise is overdue by two days.",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "ownerId": "a8dfa9b6-a7b2-46ea-982c-622a914c00e5",
  "projectorVersion": 2,
  "rankScore": 82,
  "reasonCode": "overdue_commitment",
  "recommendationId": "7b8dfa9b-a7b2-46ea-982c-622a914c00e5",
  "recommendationRevision": 2,
  "relationshipId": "9c8dfa9b-a7b2-46ea-982c-622a914c00e5",
  "relationshipName": "Acme",
  "relationshipStateVersion": 4,
  "snoozedUntil": "2026-08-07T14:00:00Z",
  "sourceRequirements": [
    "google"
  ],
  "stateReason": "Reviewed from the portfolio attention queue.",
  "status": "active",
  "triggeringObjectRef": "commitment:8b8dfa9b-a7b2-46ea-982c-622a914c00e5",
  "updatedAt": "2026-07-31T14:00:00Z",
  "urgencyBand": "high",
  "version": 1
}

Changes

No operation changes recorded.