Relationship Intelligence

Create from promises they accepted

Create from promises they accepted posts the ids of promises they accepted that are still open. The stored plan status is draft.

post/v1/relationships/{relationshipId}/mutual-action-plans

Request

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

Path parameters

relationshipIdstring uuid required

Relationship id.

Request body

commitmentIdsstring[] required

Commitment ids.

Example request

{
  "commitmentIds": [
    "8b8dfa9b-a7b2-46ea-982c-622a914c00e5"
  ]
}

Response

Draft plan.

counterpartyRefstring required

The other party.

internalOwnerRefstring uuid required

Person who owns the plan inside this workspace.

planIdstring required

Plan id.

relationshipIdstring uuid required

Company id.

status'draft' | 'revised' | 'internally_approved' | 'shared' | 'counterparty_responded' | 'completed' | 'cancelled' required

Plan status.

tokenState'not_issued' | 'active' required

Share token state.

Example response

{
  "counterpartyRef": "jordan@example.com",
  "currentRevision": {
    "createdAt": "2026-07-18T17:30:00Z",
    "createdBy": "7b8dfa9b-a7b2-46ea-982c-622a914c00e5",
    "items": [
      {
        "commitmentId": "8b8dfa9b-a7b2-46ea-982c-622a914c00e5",
        "dependencyItemIds": [
          "item:8b8dfa9b-a7b2-46ea-982c-622a914c00e5"
        ],
        "dueAt": "2026-07-22T17:00:00Z",
        "evidenceRefs": [
          "revenue-evidence:6b8dfa9b-a7b2-46ea-982c-622a914c00e5"
        ],
        "itemId": "item:8b8dfa9b-a7b2-46ea-982c-622a914c00e5",
        "ownerParticipantRef": "alex@example.com",
        "status": "open",
        "title": "Send the security packet."
      }
    ],
    "planId": "plan:eb8dfa9b-a7b2-46ea-982c-622a914c00e5",
    "revisionHash": "sha256:b718e82644ea4d98cb7a1f3ee6503cd6d3463df9c211e85051737f7654067f4d",
    "revisionId": "revision:0c8dfa9b-a7b2-46ea-982c-622a914c00e5",
    "version": 1
  },
  "internalOwnerRef": "7b8dfa9b-a7b2-46ea-982c-622a914c00e5",
  "planId": "plan:eb8dfa9b-a7b2-46ea-982c-622a914c00e5",
  "relationshipId": "9c8dfa9b-a7b2-46ea-982c-622a914c00e5",
  "status": "draft",
  "tokenState": "not_issued"
}

Changes

No operation changes recorded.