Lap Agent Analytics Api

Agent Analytics API skill. Use when working with Agent Analytics for track, stats, events. Covers 32 endpoints.

Security Scan

The skill's requirements and instructions match its stated purpose (calling an Agent Analytics HTTP API using an API key); nothing requested or described appears disproportionate.

Purpose & Capability

Name/description, listed endpoints, and required env var (AGENT_ANALYTICS_API_KEY) align: this is an HTTP client for Agent Analytics (api.agentanalytics.sh). No unrelated credentials, binaries, or system paths are requested. Note: the skill's source/homepage are not provided in the registry metadata (provenance unknown), but that does not create an internal incoherence.

Instruction Scope

SKILL.md limits actions to constructing requests against the listed endpoints and suggests verifying access (GET /stats) and creating a track (POST /track). It references an external file (references/api-spec.lap) for detailed schemas and includes optional CLI examples using npx @lap-platform/lapsh to fetch the spec; fetching with npx would download code at runtime if executed, so agents/operators should be mindful before running those optional commands. The instructions do not direct reading unrelated files or extra environment variables.

Install Mechanism

Instruction-only skill with no install spec and no code files — nothing is written to disk by the skill itself. Low install risk.

Credentials

Only a single env var is required (AGENT_ANALYTICS_API_KEY), which is appropriate for the described API client. The SKILL.md does not reference other env vars or system secrets.

Persistence & Privilege

always is false and normal autonomous invocation is allowed. The skill does not request elevated or persistent system-wide privileges or access to other skills' configs.

Assessment

This skill appears coherent for calling the Agent Analytics API, but check provenance: the registry metadata has no homepage or source URL. Before installing, ensure the AGENT_ANALYTICS_API_KEY you provide is scoped with least privilege and is rotatable. Expect the skill to contact api.agentanalytics.sh — don't reuse high-privilege keys. Be cautious about executing the optional npx @lap-platform/lapsh CLI commands (they download/run a package); only run them if you trust the package. Finally, consider privacy implications: analytics track events that may contain user data, so verify who controls the target service and its data retention/privacy policies.

Agent Analytics API

API version: 1.0.0

Auth

ApiKey X-API-Key in header | ApiKey token in query

Base URL

https://api.agentanalytics.sh

Setup

1. Set your API key in the appropriate header
2. GET /stats -- verify access
3. POST /track -- create first track

Endpoints

32 endpoints across 19 groups. See references/api-spec.lap for full details.

track

Method	Path	Description
POST	/track	Track a single event
POST	/track/batch	Track multiple events

stats

Method	Path	Description
GET	/stats	Aggregated stats overview

events

Method	Path	Description
GET	/events	Raw event log

query

Method	Path	Description
POST	/query	Flexible analytics query

properties

Method	Path	Description
GET	/properties	Discover event names and property keys
GET	/properties/received	Property keys by event name

sessions

Method	Path	Description
GET	/sessions	List sessions
GET	/sessions/distribution	Session duration histogram

breakdown

Method	Path	Description
GET	/breakdown	Top property values

insights

Method	Path	Description
GET	/insights	Period-over-period comparison

pages

Method	Path	Description
GET	/pages	Entry/exit page stats

heatmap

Method	Path	Description
GET	/heatmap	Day-of-week x hour traffic grid

funnel

Method	Path	Description
POST	/funnel	Funnel analysis

retention

Method	Path	Description
GET	/retention	Cohort retention analysis

stream

Method	Path	Description
GET	/stream	Live event stream (SSE)

live

Method	Path	Description
GET	/live	Live snapshot (real-time)

projects

Method	Path	Description
GET	/projects	List all projects
POST	/projects	Create a new project
GET	/projects/{id}	Get project details
PATCH	/projects/{id}	Update a project
DELETE	/projects/{id}	Delete a project

account

Method	Path	Description
GET	/account	Get account info
POST	/account/revoke-key	Revoke and regenerate API key

experiments

Method	Path	Description
GET	/experiments/config	Get experiment config for tracker.js
POST	/experiments	Create an A/B experiment
GET	/experiments	List experiments
GET	/experiments/{id}	Get experiment with live results
PATCH	/experiments/{id}	Update experiment status
DELETE	/experiments/{id}	Delete an experiment

health

Method	Path	Description
GET	/health	Health check

tracker.js

Method	Path	Description
GET	/tracker.js	JavaScript tracker script

Common Questions

Match user requests to endpoints in references/api-spec.lap. Key patterns:

• "Create a track?" -> POST /track
• "Create a batch?" -> POST /track/batch
• "List all stats?" -> GET /stats
• "List all events?" -> GET /events
• "Create a query?" -> POST /query
• "List all properties?" -> GET /properties
• "List all received?" -> GET /properties/received
• "List all sessions?" -> GET /sessions
• "List all breakdown?" -> GET /breakdown
• "List all insights?" -> GET /insights
• "List all pages?" -> GET /pages
• "List all distribution?" -> GET /sessions/distribution
• "List all heatmap?" -> GET /heatmap
• "Create a funnel?" -> POST /funnel
• "List all retention?" -> GET /retention
• "List all stream?" -> GET /stream
• "List all live?" -> GET /live
• "List all projects?" -> GET /projects
• "Create a project?" -> POST /projects
• "Get project details?" -> GET /projects/{id}
• "Partially update a project?" -> PATCH /projects/{id}
• "Delete a project?" -> DELETE /projects/{id}
• "List all account?" -> GET /account
• "Create a revoke-key?" -> POST /account/revoke-key
• "List all config?" -> GET /experiments/config
• "Create a experiment?" -> POST /experiments
• "List all experiments?" -> GET /experiments
• "Get experiment details?" -> GET /experiments/{id}
• "Partially update a experiment?" -> PATCH /experiments/{id}
• "Delete a experiment?" -> DELETE /experiments/{id}
• "List all health?" -> GET /health
• "List all tracker.js?" -> GET /tracker.js
• "How to authenticate?" -> See Auth section

Response Tips

• Check response schemas in references/api-spec.lap for field details
• List endpoints may support pagination; check for limit, offset, or cursor params
• Create/update endpoints typically return the created/updated object

CLI

# Update this spec to the latest version
npx @lap-platform/lapsh get agent-analytics-api -o references/api-spec.lap

# Search for related APIs
npx @lap-platform/lapsh search agent-analytics-api

References

• Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

Generated from the official API spec by LAP