Relationship Intelligence

Create a commitment dependency

Creates an evidence-backed dependency after enforcing tenant and relationship scope and rejecting graph cycles.

post/v1/relationships/{relationshipId}/commitment-dependencies

Request

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

Path parameters

relationshipIdstring uuid required

Relationship id.

Request body

evidenceRefsstring[] required

Evidence references.

fromCommitmentIdstring uuid required

Origin commitment id.

kind'blocks' | 'requires' | 'supersedes' required

Dependency semantics.

toCommitmentIdstring uuid required

Target commitment id.

Example request

{
  "evidenceRefs": [
    "relationship-observation:ab12"
  ],
  "fromCommitmentId": "8b8dfa9b-a7b2-46ea-982c-622a914c00e5",
  "kind": "blocks",
  "toCommitmentId": "26cdbdc9-d0fc-4f8c-8660-2f0d62cfef51"
}

Response

Created dependency.

createdAtstring date-time required

Creation time.

dependencyIdstring uuid required

Dependency id.

evidenceRefsstring[] required

Evidence references.

fromCommitmentIdstring uuid required

Origin commitment id.

kind'blocks' | 'requires' | 'supersedes' required

Dependency semantics.

relationshipIdstring uuid required

Relationship id.

toCommitmentIdstring uuid required

Target commitment id.

Example response

{
  "createdAt": "2026-08-01T14:00:00Z",
  "dependencyId": "3b8dfa9b-a7b2-46ea-982c-622a914c00e5",
  "evidenceRefs": [
    "relationship-observation:ab12"
  ],
  "fromCommitmentId": "8b8dfa9b-a7b2-46ea-982c-622a914c00e5",
  "kind": "blocks",
  "relationshipId": "9c8dfa9b-a7b2-46ea-982c-622a914c00e5",
  "toCommitmentId": "26cdbdc9-d0fc-4f8c-8660-2f0d62cfef51"
}

Changes

No operation changes recorded.