Sign in
Revenue

Execute

Changed on

Execute posts the one-time value Approve and run returned. The page shows the result while it waits for the product to confirm the change.

post/v1/action-proposals/{id}/execute

Request

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

Path parameters

idstring uuid required

Proposal id.

Example:5f8dfa9b-a7b2-46ea-982c-622a914c00e5

Request body

tokenstring required

One-time value from Approve and run. This sample is not a live approval.

Example request

{
  "token": "example.not-a-live-approval"
}

Response

Executed proposal.

approvedAtstring date-time required

When it was approved.

createdAtstring date-time required

When the proposal was created.

executedAtstring date-time required

When it ran.

financialboolean required

Whether money moves.

idstring uuid required

Proposal id.

kindstring required

Action kind.

paramsJsonstring

JSON parameters.

rationalestring

Why the action was proposed.

resultRefstring

Result the page shows.

statusstring required

Executed.

targetstring required

Object the action changes.

Example response

{
  "approvedAt": "2026-07-31T14:00:00Z",
  "createdAt": "2026-07-31T14:00:00Z",
  "executedAt": "2026-07-31T14:00:00Z",
  "id": "5f8dfa9b-a7b2-46ea-982c-622a914c00e5",
  "kind": "conduit.dunning.advance",
  "paramsJson": "{\"amount\":100,\"step\":2}",
  "rationale": "Acme is 14 days overdue",
  "resultRef": "conduit:step:step_1",
  "status": "executed",
  "target": "conduit:invoice:inv_456"
}

Changes