---
title: "Ingest monitoring browser event"
method: POST
path: "/api/v1/lens/beacon"
tags: ["Diagnostics"]
---

# Ingest monitoring browser event

`POST /api/v1/lens/beacon`

## Request

- Base URL: `https://agenticcom.ai`
- URL: `https://agenticcom.ai/api/v1/lens/beacon`
- Auth: none declared

Public compatibility endpoint for optional storefront theme-extension page-view signals. Browser collection cannot observe crawlers that do not run JavaScript.

## Request body

- LensBeaconRequest: Stable compatibility schema for optional monitoring page-view events.
  - `site_id` string, required
  - `api_key` string
  - `url` string, required
  - `referrer` string, nullable
  - `user_agent` string, nullable
  - `timestamp` integer

## Response `200`

Beacon processed.

- LensBeaconResponse
  - `ok` boolean
  - `recorded` boolean

## Other responses

- `400`: Invalid payload.
- `401`: Unauthorized keyed beacon request.
- `403`: Forbidden keyed beacon request.

---

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