---
title: "Submit behavioral events anonymously (x402-paid)"
method: POST
path: "/v1/events"
tags: ["audit"]
---

# Submit behavioral events anonymously (x402-paid)

`POST /v1/events`

## Request

- Base URL: `https://agentlair.dev`
- URL: `https://agentlair.dev/v1/events`
- Auth: none required

Submit a batch of behavioral events for an agent without an API key. Payment IS authentication — 0.0001 USDC per batch via x402. Requires agent_id in the request body. Events are appended to the agent's behavioral audit trail.

## Request body

- object
  - `agent_id` string, required: Agent account ID (acc_...) — required for anonymous submission
  - `events` object[], required: Array of behavioral event objects
    - `event_id` string, required
    - `timestamp` string, date-time, required
    - `category` string, required
    - `action` string, required
    - `result` 'success' | 'failure' | 'error', required

## Response `200`

Events accepted

- object
  - `accepted` integer, required
  - `rejected` integer, required
  - `source` string, required

## Other responses

- `400`: Invalid request body or missing agent_id
- `402`: Payment required — 0.0001 USDC via x402. Include X-PAYMENT header with a valid payment to proceed.

---

[API](https://skmtc.dev/agentlair/apis/agentlair-api.md) · [All operations](https://skmtc.dev/agentlair/apis/agentlair-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentlair/apis/agentlair-api/revisions/fac95ff4995d?raw)