Generated by API Evangelist
Written by API Evangelist tooling for Agoragentic's API. It is a proposal applied on top of the contract, not a document Agoragentic publishes.
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
title: API Evangelist conversational phrasing for Agoragentic Agent OS and Marketplace Router Analytics API
version: 1.0.0
extends: openapi/agoragentic-com-analytics-api-openapi.yml
actions:
- target: $.info
update:
x-apievangelist-phrasing:
method: generated
generated: '2026-09-26'
generator: build-phrasing.py
label: Generated by API Evangelist
operations: 4
- target: $.paths['/v1/analytics/pageview'].post
update:
x-apievangelist-phrasing:
intent: Record a page view
effect: write
questions:
- How do I track a page view once the visitor has given analytics consent?
- What happens if I send a pageview without current consent?
instructions:
- text: Record a pageview of {page} under consent version {consent_version}.
slots:
page: requestBody.page
consent_version: requestBody.consent_version
- text: Log a visit to {page} from referrer {referrer} for session {session_id}, consent {consent_version}.
slots:
page: requestBody.page
referrer: requestBody.referrer
session_id: requestBody.session_id
consent_version: requestBody.consent_version
method: generated
generated: '2026-09-26'
- target: $.paths['/v1/analytics/event'].post
update:
x-apievangelist-phrasing:
intent: Record a custom analytics event
effect: write
questions:
- How do I track a custom event like a button click with a category and label?
- Can I attach a numeric value to a tracked event?
instructions:
- text: Track event {event} with consent version {consent_version}.
slots:
event: requestBody.event
consent_version: requestBody.consent_version
- text: Record event {event} in category {category} labeled {label} with value {value}, consent {consent_version}.
slots:
event: requestBody.event
category: requestBody.category
label: requestBody.label
value: requestBody.value
consent_version: requestBody.consent_version
method: generated
generated: '2026-09-26'
- target: $.paths['/v1/analytics/funnel'].post
update:
x-apievangelist-phrasing:
intent: Record a funnel step
effect: write
questions:
- How do I log that a user reached a particular step in a conversion funnel?
- Can funnel steps carry a name and extra metadata?
instructions:
- text: Record step {step} of funnel {funnel} under consent {consent_version}.
slots:
step: requestBody.step
funnel: requestBody.funnel
consent_version: requestBody.consent_version
- text: Log funnel {funnel} step {step} named {step_name} for session {session_id}, consent {consent_version}.
slots:
funnel: requestBody.funnel
step: requestBody.step
step_name: requestBody.step_name
session_id: requestBody.session_id
consent_version: requestBody.consent_version
method: generated
generated: '2026-09-26'
- target: $.paths['/audit/logs'].get
update:
x-apievangelist-phrasing:
intent: View the platform audit trail
effect: read
questions:
- Where can I see the immutable log of platform events?
- How many audit log entries can I pull at once?
instructions:
- text: Show the platform audit log.
- text: Get the latest {limit} audit trail entries.
slots:
limit: query.limit
method: generated
generated: '2026-09-26'
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.