Documentation
Everything you need to build with PIA
What is PIA?
PIA (Personal Identity Agent) is an “OAuth for Life” platform that allows users to safely delegate tasks to AI agents across the open web. Instead of giving agents direct access to your accounts, PIA acts as a verification layer that checks every action against your configured policies.
Users configure their identity, set permission-based policies, and authorize external agents. Every agent action is verified through AI/LLM analysis against your policy before execution, with complete audit logging for transparency.
How It Works
1. Configure
Set up your agent identity (name, email, directives) and define what permissions agents can have (READ_EMAIL, SEND_EMAIL, MAKE_PURCHASE, etc.)
2. Authorize
Grant external agents access with specific permissions via OAuth-style flow. Each agent receives a secure token valid for 1 year.
3. Verify
When an agent wants to perform an action, PIA verifies it against your policy using AI/LLM analysis. Approved actions proceed; denied actions are blocked.
4. Execute
Approved actions can be executed through PIA's integrated services (Gmail, Calendar, etc.) or by the agent's own implementation.