agent-verify

✅ Verify API Reference

Proof-of-work and attestation primitives. Let agents prove they did what they claimed — with timestamped, verifiable proofs.

🚧 Coming Soon — This service is in development. Join the waitlist to get early access when it launches.

🔑 Base URL: https://api.agenttool.dev · All endpoints require Authorization: Bearer YOUR_API_KEY

POST /v1/verify/verify

Create a verifiable attestation for an agent action. The API generates a SHA-256 proof, timestamps it, and returns a verification ID that third parties can independently verify.

🔒 Bearer token required

Request Body

Field	Type	Required	Description
action	string	required	Description of the action being attested (e.g. `"completed_task"`).
agent_id	string	required	The agent claiming the action.
payload	object	required	Arbitrary data to include in the proof. This is hashed and cannot be altered after creation.
anchor	boolean	optional	Anchor the proof to a blockchain for tamper-proof timestamping. Default: `false`.
expires_at	string	optional	ISO 8601 datetime after which the attestation expires.

curl

curl -X POST https://api.agenttool.dev/v1/verify/verify \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "completed_task",
    "agent_id": "agent-42",
    "payload": {
      "task_id": "task-789",
      "result": "Generated quarterly report",
      "tokens_used": 4200
    },
    "anchor": false
  }'

SDK

const proof = await at.verify.attest({
  action: "completed_task",
  agentId: "agent-42",
  payload: {
    taskId: "task-789",
    result: "Generated quarterly report",
    tokensUsed: 4200
  }
})

Response · 201

JSON

{
  "verification_id": "vrf_a1b2c3d4e5f6",
  "proof_hash": "sha256:3d7b9e1f2a4c6d8e0b5a7c9d1f3e5a7b...",
  "timestamp": "2026-03-09T12:00:00Z",
  "agent_id": "agent-42",
  "action": "completed_task",
  "anchored": false,
  "verify_url": "https://api.agenttool.dev/v1/verify/vrf_a1b2c3d4e5f6"
}

💡 Third-party verification: Share the verify_url with anyone. They can GET it without an API key to independently confirm the attestation is genuine and unaltered.

422 · Validation Error

Missing required fields. Ensure action, agent_id, and payload are all provided.

Use Cases

📋

Task Completion

Prove an agent completed a task with specific outputs. Include task ID, result summary, and resource usage in the payload.

🔗

Agent-to-Agent Trust

When agents delegate work, the worker can produce a verifiable proof that the delegator can independently check.

📊

Audit Trails

Create an immutable record of agent decisions and actions. Each verification is timestamped and hash-linked.

⛓️

Blockchain Anchoring

For high-stakes attestations, anchor proofs to a blockchain. Provides tamper-proof timestamping that's independent of AgentTool.

Error Reference

401 · Unauthorized

Missing or invalid API key.

422 · Validation Error

Request body is invalid. Ensure all required fields (action, agent_id, payload) are present and correctly typed.

429 · Rate Limited

Too many verification requests. Verifications are rate-limited to prevent abuse.