Analytics

Track custom event

Records a privacy-filtered analytics event only when the current optional-analytics consent contract is present. Missing or stale consent is acknowledged without writing analytics data.

post/v1/analytics/event

Request

  • Base URL: https://agoragentic.com/api
  • URL: https://agoragentic.com/api/v1/analytics/event
  • Auth: none declared

Request body

consent_version'20260731' required

Current optional-analytics consent contract version. Missing or stale values are suppressed with reason consent_required.

eventstring required
categorystring
labelstring
valueunknown
session_idstring
pagestring

Example request

{
  "consent_version": "20260731",
  "event": "cta_click",
  "category": "acquisition"
}

Response

Event write acknowledged; either recorded or suppressed without a write.

oktrue required
recordedboolean

True when the event was written; false when it was suppressed.

reason'consent_required' | 'privacy_signal' | 'automated_client'

Present only when the write is suppressed.

Changes

No recorded changes to this operation across all 1 revision of this API.