Relationship Intelligence

Approve this plan

Changed on

Approve this plan posts an empty body. The stored plan status is internally_approved, which the company sheet reads as Approved in this workspace.

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

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/{planId}/approve
  • Auth: HTTP bearer

Path parameters

relationshipIdstring uuid required

Relationship id.

planIdstring required

Mutual action plan id.

Request body

object required

Plan approval request.

Response

Approved 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.

sharePolicyDecisionIdstring

Decision recorded when the plan was shared.

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-31T14:00:00Z",
    "createdBy": "7b8dfa9b-a7b2-46ea-982c-622a914c00e5",
    "items": [
      {
        "commitmentId": "8b8dfa9b-a7b2-46ea-982c-622a914c00e5",
        "dependencyItemIds": [
          "item:8b8dfa9b-a7b2-46ea-982c-622a914c00e5"
        ],
        "dueAt": "2026-09-14T17: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:ab8dfa9b-a7b2-46ea-982c-622a914c00e5",
    "revisionHash": "sha256:935371863ce9346ba2c85a787c066e76f7afd07a607fab5a9c3badb5034a4966",
    "revisionId": "revision:cb8dfa9b-a7b2-46ea-982c-622a914c00e5",
    "version": 1
  },
  "internalOwnerRef": "7b8dfa9b-a7b2-46ea-982c-622a914c00e5",
  "planId": "plan:ab8dfa9b-a7b2-46ea-982c-622a914c00e5",
  "relationshipId": "9c8dfa9b-a7b2-46ea-982c-622a914c00e5",
  "sharePolicyDecisionId": "governance:ab8dfa9ba7b246ea982c622a",
  "status": "internally_approved",
  "tokenState": "not_issued"
}

Changes

  • d39ed3e21b7aRevision changes
    • breaking

      removed the success response with the status

    • info

      added the success response with the status

  • 3a2247461042Revision changes
    • breaking

      removed the success response with the status

    • info

      added the success response with the status