Event Reference

Complete reference of all webhook events with their payload schemas. Every event follows the same top-level envelope — the examples below show the data field for each event type.

Agent Events

`agent.registered`

Fired when a new agent is registered on the protocol.

agent.registered — data

{  "id": "agent_7f3k9x2m",  "name": "Trading Agent Alpha",  "fingerprint": "sha256:9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",  "environment": "production",  "status": "active",  "created_at": "2025-01-15T10:30:00Z"}

`agent.suspended`

Fired when an agent is suspended due to policy violation or manual action.

agent.suspended — data

{  "id": "agent_7f3k9x2m",  "name": "Trading Agent Alpha",  "status": "suspended",  "suspended_at": "2025-02-01T14:22:00Z"}

`agent.reactivated`

Fired when a previously suspended agent is reactivated.

agent.reactivated — data

{  "id": "agent_7f3k9x2m",  "name": "Trading Agent Alpha",  "status": "active"}

`agent.deleted`

Fired when an agent is permanently deleted from the protocol.

agent.deleted — data

{  "id": "agent_7f3k9x2m",  "name": "Trading Agent Alpha",  "deleted_at": "2025-03-10T09:00:00Z"}

Transaction Events

`transaction.completed`

Fired when a transaction completes successfully.

transaction.completed — data

{  "id": "tx_r4s5t6u7v8",  "agent_id": "agent_7f3k9x2m",  "counterparty_id": "agent_2b8m4p1q",  "amount": 500.00,  "currency": "USD",  "action_type": "transfer_funds",  "status": "completed"}

`transaction.failed`

Fired when a transaction fails during execution.

transaction.failed — data

{  "id": "tx_w9x0y1z2a3",  "agent_id": "agent_7f3k9x2m",  "error_code": "INSUFFICIENT_TRUST",  "error_message": "Agent trust score below minimum threshold for this action."}

`transaction.reversed`

Fired when a previously completed transaction is reversed.

transaction.reversed — data

{  "id": "tx_b4c5d6e7f8",  "original_transaction_id": "tx_r4s5t6u7v8",  "agent_id": "agent_7f3k9x2m",  "amount": 500.00}

Trust Events

`trust.score_changed`

Fired when an agent's trust score changes significantly (more than 50 points or a change in assessment tier).

trust.score_changed — data

{  "agent_id": "agent_7f3k9x2m",  "previous_score": 820,  "new_score": 650,  "assessment": "Moderate",  "reason": "Multiple failed transactions detected in the last 24 hours."}

`trust.dispute_filed`

Fired when a dispute is filed against an agent.

trust.dispute_filed — data

{  "dispute_id": "disp_g9h0i1j2k3",  "agent_id": "agent_7f3k9x2m",  "reporter_id": "agent_2b8m4p1q",  "reason": "Agent failed to deliver agreed-upon data processing results."}