Replace an expired unsubmitted action with a freshly validated receipt-bound action

post/v2/session/{session_id}/refresh-action

Request

  • Base URL: https://api.assetfare.dev
  • URL: https://api.assetfare.dev/v2/session/{session_id}/refresh-action
  • Auth: none required

Path parameters

session_idstring uuid required

Headers

X-AssetFare-Session-Tokenstring required

Caller-generated opaque capability token (>=256-bit CSPRNG, urlsafe-base64). The caller supplies it on the FIRST POST /v2/session (create) and on every read/observe/refresh. The server stores only its sha256 hash and never returns the raw token. The calling network identity is NOT the authorization secret, so a rotated egress IP that presents the correct token keeps access; a retry with the same token+idempotency_key recovers a session whose create response was lost.

Request body

idempotency_keystring required
transaction_hashstring

Response

Fresh current action with ActionSafetyReceiptV1

action_availableboolean required
server_signingunknown required
server_submissionunknown required
session_idstring uuid required
signedunknown required
statusstring required
submittedunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.