Delegation API
HTTP mirror for Gator/ERC-7710 delegation. Prefer MCP delegation tools or Agent CLI delegation commands.
Default path: MCP delegation tools or Agent CLI delegation. This page maps the underlying REST lifecycle.
External wallet delegation uses Gator-compatible ERC-7710 payloads. Private keys never leave the user wallet.
Lifecycle
| Step | Endpoint | Description |
|---|---|---|
| 1. Create | POST /api/v1/agent/delegation/create | Build delegation payload with caveats for owner to sign |
| 2. Activate | POST /api/v1/agent/delegation/activate | Persist signed delegation and metadata |
| 3. Check | GET /api/v1/agent/delegation/check | Quick status for fan-out gates |
| 4. Verify | GET /api/v1/agent/delegation/verify | Deeper validation against on-chain state |
Authenticated agent context required. See Execute Intent API for auth headers.
When delegation is required
Delegation gates apply for:
POST /api/v1/agent/execute-intentfan-out to delegated usersthirdfyandhybridmanaged execution- CEX credentials and delegated external accounts
- Provider paths that require delegated user authority
Not required for direct agent_wallet execution when the identity is agent-owned, or for self BYOW when the local wallet signs.
MCP and CLI equivalents
| REST | MCP | CLI |
|---|---|---|
| create | delegationCreate | delegation create / delegation grant |
| activate | delegationActivate | delegation activate |
| check / verify | delegationStatus | delegation status |
| inspect | delegationInspect | delegation inspect |
| balance | delegationBalance | delegation balance |
| redeem | delegationRedeem | delegation redeem |
| revoke | delegationRevoke | delegation revoke |