Sign in
Policies

Revoke a session policy

Outcomes:

  • status: deleted — rare: no InstallCall retained; record removed.
  • status: revoked, onChainCleanupRequired: false — pending grant retained so InstallCall survives a late-landing install (orphan path). Not known on chain yet; no cleanup payload.
  • status: revoked, onChainCleanupRequired: true — applied grant still believed installed. Response includes onChainCleanup (uninstallValidation call for the owner wallet: plain tx to the runner, or owner-fallback UserOp). Once teardown is verified, GET no longer returns cleanup for that policy.
delete/wallets/{address}/policies/{policyId}

Response

Revocation outcome.

status'deleted' | 'revoked' required

deleted = was pending, nothing was ever installed. revoked = retained for audit.

onChainCleanupRequiredboolean required

True when the grant's validation is still installed on the account and needs the owner's uninstallValidation to clear.

Example response

{
  "onChainCleanup": {
    "target": "0x82F2Dd9a552a69f2ceD7Ff2D05c43aB8430158FB"
  }
}

Changes

Changed in 2 of the 17 revisions of this API.2