Fingerprint and atomically lock an action intent

LockMyAction: derive a stable idempotency key from a structured action and atomically claim it in one call. Execute the external action only when safe_to_execute is true. Reordered JSON object keys resolve to the same lock.

post/v1/actions/lock-intent

Request

  • Base URL: https://api.scrubmytext.com
  • URL: https://api.scrubmytext.com/v1/actions/lock-intent
  • Auth: HTTP bearer

Request body

actionstring required

Stable action name, such as refund_order or send_email.

argumentsobject required

JSON object containing the action inputs. Object keys are sorted during canonicalization; array order remains significant.

scopestring

Optional namespace used to separate otherwise identical action intents.

lock_ttl_secondsinteger
completion_ttl_secondsinteger

Response

Action intent fingerprinted and lock result returned

brand'LockMyAction' required
statusstring required
safe_to_executeboolean required
keystring required
lock_idstring
action_fingerprintstring required
idempotency_keystring required
algorithm'sha256' required
canonicalizationstring required
canonical_bytesinteger required

Changes

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