Relationship Intelligence

Company graph

Company graph loads the portfolio. The request asks for the portfolio at depth 2 and does not ask for an earlier moment or an older page. This workspace has no company, so the graph is empty.

get/v1/relationships/graph

Request

Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
URL: /v1/relationships/graph
Auth: HTTP bearer

Query parameters

scope'portfolio' | 'relationship'

Example:portfolio

portfolio is the whole workspace. Company graph asks for the portfolio.

relationshipIdstring uuid

One company. Company graph does not send this for the portfolio.

depthinteger

Example:2

How far the graph expands (1-3). Company graph asks for 2.

asOfstring date-time

An earlier moment. Company graph does not send this on the first load.

offsetinteger

How many companies to skip. Company graph does not send this on the first page.

observationOffsetinteger

How many conversations to skip. Company graph does not send this on the first page.

Response

Empty company graph.

asOfstring date-time required

Historical evidence boundary.

contractVersionstring required

Wire contract version.

depthinteger required

generatedAtstring date-time required

Projection generation time.

hasMoreboolean

Another company exists beyond this page.

historicalboolean required

Whether the response is an historical projection.

observationHasMoreboolean

An older conversation exists beyond this page.

relationshipIdstring uuid

Relationship id for account scope.

scope'portfolio' | 'relationship' required

Graph scope.

Example response

{
  "asOf": "2026-08-01T14:00:00Z",
  "contractVersion": "2026-08-01",
  "depth": 2,
  "edges": [
    {
      "confidence": 0.88,
      "directed": true,
      "evidenceRefs": [
        "4b8dfa9b-a7b2-46ea-982c-622a914c00e5"
      ],
      "id": "edge:ab12cd34",
      "kind": "requires",
      "label": "requires",
      "source": "commitment:8b8dfa9b-a7b2-46ea-982c-622a914c00e5",
      "target": "commitment:26cdbdc9-d0fc-4f8c-8660-2f0d62cfef51"
    }
  ],
  "generatedAt": "2026-08-01T14:00:00Z",
  "hasMore": true,
  "nodes": [
    {
      "approvalStatus": "pending",
      "changedDimensions": [
        "health"
      ],
      "changedSinceReview": true,
      "confidence": 0.88,
      "dueAt": "2026-08-12T14:00:00Z",
      "engagement": "declining",
      "evidenceRefs": [
        "4b8dfa9b-a7b2-46ea-982c-622a914c00e5"
      ],
      "executionStatus": "ambiguous",
      "freshness": "current",
      "health": "needs_attention",
      "id": "relationship:9c8dfa9b-a7b2-46ea-982c-622a914c00e5",
      "kind": "relationship",
      "label": "Northstar Labs",
      "lifecycle": "renewal",
      "occurredAt": "2026-08-01T14:00:00Z",
      "policyStatus": "passed",
      "priority": 82,
      "relationshipId": "9c8dfa9b-a7b2-46ea-982c-622a914c00e5",
      "relationshipIds": [
        "9c8dfa9b-a7b2-46ea-982c-622a914c00e5"
      ],
      "resourceRef": "9c8dfa9b-a7b2-46ea-982c-622a914c00e5",
      "role": "champion",
      "sentiment": "mixed",
      "source": "meeting",
      "status": "active",
      "summary": "Security review is overdue.",
      "updatedAt": "2026-08-01T14:00:00Z"
    }
  ],
  "observationHasMore": true,
  "permissions": {
    "canContribute": true,
    "canSaveViews": true,
    "canView": true
  },
  "relationshipId": "9c8dfa9b-a7b2-46ea-982c-622a914c00e5",
  "scope": "portfolio"
}

Changes

No operation changes recorded.