Send Agent EventsPOST /agent-events

Send an Agent Event

Send AI Visibility agent events to Hardal.

curl -X POST "https://analytics.usehardal.com/agent-events" \
  -H "Content-Type: application/json" \
  -H "Tenant-Id: YOUR_TENANT_ID" \
  -d '{
  "path": "/local-test",
  "ip": "87.250.224.230",
  "userAgent": "Mozilla/5.0 (compatible; YandexNews/4.0; +http://yandex.com/bots)",
  "eventTime": "2026-04-29T15:12:17.836Z",
  "sourceId": "hardal"
}'
{}
POST
/agent-events
POST
Base URLstring

Target server for requests. Edit to use your own host.

Content-Typestring
Required

The media type of the request body

Options: application/json
header
Tenant-Idstring
Required

Your Tenant ID from the Hardal dashboard.

pathstring
Required

Requested path on the website.

ipstring
Required

Visitor IP address.

userAgentstring
Required

Raw User-Agent header from the request.

eventTimestring
Required

Request time in ISO 8601 format.

Format: date-time
sourceIdstring
Required

Your Source ID from the Hardal dashboard.

Request Preview
Response

Response will appear here after sending the request

Headers

Tenant-Idstring
Required

Your Tenant ID from the Hardal dashboard.

Example:
YOUR_TENANT_ID

Body

application/json
pathstring
Required

Requested path on the website.

Example:
/local-test
ipstring
Required

Visitor IP address.

Example:
87.250.224.230
userAgentstring
Required

Raw User-Agent header from the request.

Example:
Mozilla/5.0 (compatible; YandexNews/4.0; +http://yandex.com/bots)
eventTimestring
Required

Request time in ISO 8601 format.

Example:
2026-04-29T15:12:17.836Z
sourceIdstring
Required

Your Source ID from the Hardal dashboard.

Example:
hardal

Responses

Agent event received successfully.