1
Install the SDK
pip install permission-protocolQuickstart
Install the SDK, configure your key, wrap your first action, approve it, and verify the receipt.
pip install permission-protocolimport permission_protocol as pp
pp.configure(api_key="pp_key_...")Get your free API key at permissionprotocol.com/developers
from permission_protocol import require_approval
@require_approval
def deploy_service():
deploy("billing-api")
# Agent calls deploy_service()
# -> Paused until authorizedAny function decorated with @require_approval will pause until authorized.
receipt = deploy_service()
# A notification appears in the dashboard
# The action is blocked until someone clicks ApproveWhen the guarded action runs, a notification appears in the dashboard. The action stays blocked until this approval step completes.
PENDING IN DASHBOARD
Action blocked until approvedAPPROVAL REQUIRED
deploy_service -> billing-api
Agent: release-bot-v2
Requested by: ci.prod.pipeline
receipt = deploy_service()
receipt.verified # TrueRECEIPT RETURNED
pp_r_8f91c2
Every receipt is cryptographically signed, portable, and auditable, so you can verify exactly what was authorized after the fact.