Actions and receipts

Settle an action

POST/v1/actions/:id/settle

Report what actually happened after an allowed action, so the ledger holds the outcome and not only the permission. Settling above the authorised amount is recorded as an incident and alerts the owner. With the card rail, the issuer’s clearing settles card payments instead.

Field	Type	Required	Description
`status`	string	yes	`completed`, `failed` or `cancelled`
`amount`	integer	for payments	the final amount in minor units

#Authentication

Agent key

An agent-scoped key (ask_...) bound to exactly one agent, or an OAuth access token (aat_...) issued to an MCP client for that agent, sent as Authorization: Bearer. An agent key may ask, poll and settle. It can never approve, widen a mandate or lift a freeze.

#Path parameters

idstringrequired

Action id

Request

curl -X POST "https://immiscible.fly.dev/v1/actions/act_7Qm2c1f0/settle" \
  -H "authorization: Bearer $IMMISCIBLE_AGENT_KEY" \
  -H "content-type: application/json" \
  -d '{
    "status": "completed",
    "amount": 4200
  }'

import { Immiscible } from '@immiscible/sdk';

// Reads IMMISCIBLE_AGENT_KEY and IMMISCIBLE_URL
const immiscible = new Immiscible();
const settled = await immiscible.settle('act_7Qm2c1f0', { status: 'completed', amount: 4200 });
console.log(settled.status);

from immiscible import Immiscible

# Reads IMMISCIBLE_AGENT_KEY and IMMISCIBLE_URL
immiscible = Immiscible()
settled = immiscible.settle("act_7Qm2c1f0", status="completed", amount=4200)
print(settled.raw["status"])

Response

JSON

{
  "id": "act_7Qm2c1f0",
  "decision": "allow",
  "status": "completed",
  "reasons": [
    "within Weekly groceries: £42.00 of £150.00 per transaction"
  ],
  "mandateId": "mdt_91c3e0b2",
  "risk": {
    "score": 8,
    "signals": []
  },
  "settlement": {
    "status": "completed",
    "amount": 4200,
    "at": "2026-10-04T10:03:40Z",
    "incident": null
  },
  "incident": null
}