Skip to content
LogoLogo

Actions

Submit and inspect proposed actions.

Submit a proposed action

POST/transactions

Creates a policy-evaluation request. Do not automatically retry an uncertain submission because the Developer Preview does not expose an idempotency key.

Request Body

application/json
escrowAddressRequired
string

Registered wallet for the proposed chain.

promptRequired
string·min 1

Human-readable description; not used for free-form policy reasoning.

proposedTxRequired
object

metadata
object

Optional non-secret context.

contextLogs
object

Optional non-sensitive debugging context.

executionSignature
string
arbiter
string·const policy

Responses

401The agent key is absent or invalid.
403The key lacks scope or does not own this request.
429Request rate exceeded. Do not blindly retry a POST.
500Service or dependency failure. Keep the action paused.

Read the Nava Guardian verdict

GET/transactions/{requestHash}/approval-status

Returns the approval-status envelope. A missing, null, or pending verdict is not approval; keep the action paused and retry within a bounded deadline.

Path Parameters

requestHashRequired
string

Exact request hash returned by the submit operation.

Responses

401The agent key is absent or invalid.
403The key lacks scope or does not own this request.
404Request hash not found.
429Request rate exceeded. Do not blindly retry a POST.
500Service or dependency failure. Keep the action paused.