POST

Build or verify an AP2 Intent Mandate as EIP-712 typed data for agent identity (spend cap, expiry, wallet). Powered by viem

/v1/agent/identity

Validation · viem-eip712

Request → Response

Examples from schemas.json.

Requestapplication/json
POST /v1/agent/identity
Content-Type: application/json

{
  "action": "build"
}
Responseapplication/json
HTTP/1.1 200 OK
Content-Type: application/json

// Endpoint-specific body after 402 settlement

Overview

Build or verify an AP2 Intent Mandate as EIP-712 typed data for agent identity (spend cap, expiry, wallet). Powered by viem.

Request schema

Body: JSON · application/json

FieldTypeDescription
actionstringrequiredenum: build, verify
intent_descriptionstringoptional
max_spend_atomicintegeroptionalmin: 0
expires_atintegeroptionalmin: -9007199254740991
agent_walletstringoptionalpattern: ^0x[0-9a-fA-F]{40}$
typed_dataobjectoptional
signaturestringoptionalpattern: ^0x[0-9a-fA-F]{130}$
IMPLEMENTATION
curl -X POST https://api.tools402.dev/v1/agent/identity \
  -H "Content-Type: application/json" \
  -d '{
  "action": "build"
}'

402 payment flow omitted — see Integrations for settlement.