You're offline

Quickstart

Your first authority receipt in 5 minutes.

Install the SDK, configure your key, wrap your first action, approve it, and verify the receipt.

1

Install the SDK

pip install permission-protocol
2

Configure your API key

import permission_protocol as pp

pp.configure(api_key="pp_key_...")

Get your free API key at permissionprotocol.com/developers

3

Add your first approval guard

from permission_protocol import require_approval

@require_approval
def deploy_service():
    deploy("billing-api")

# Agent calls deploy_service()
# -> Paused until authorized

Any function decorated with @require_approval will pause until authorized.

4

Approve the action

receipt = deploy_service()

# A notification appears in the dashboard
# The action is blocked until someone clicks Approve

When 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 approved

APPROVAL REQUIRED

deploy_service -> billing-api

Agent: release-bot-v2

Requested by: ci.prod.pipeline

Deploy unblocks invoice generation hotfix for EMEA.
5

Verify the receipt

receipt = deploy_service()

receipt.verified  # True

RECEIPT RETURNED

pp_r_8f91c2

Action
deploy_service -> billing-api
Approved by
sarah.kim
Verified
true
Signature
Cryptographically signed

Every receipt is cryptographically signed, portable, and auditable, so you can verify exactly what was authorized after the fact.

What's next?