Documentation

API Reference

Public and authenticated REST endpoints.

Public endpoints

GET /api/public/walls/[slug]

Returns published testimonials and wall settings for a public slug. No auth required. Used by public wall pages and OG image generation.

GET /api/config/[siteId]

Widget configuration for embed script (button, theme, features).

Authenticated endpoints

Require Authorization: Bearer <token> from sign-in.

Testimonials

  • GET /api/testimonials?siteId= — list (add &all=true for admin draft view)
  • PUT /api/testimonials/[id] — update publish status, metadata

Analytics

  • GET /api/analytics/stats?siteId= — aggregated metrics
  • POST /api/analytics/events — track button views, wall views, submissions

AI enrichment

  • POST /api/ai/enrich — body: { "testimonialId": "..." } — adds headline, tags, sentiment

Sites

  • GET /api/sites — list sites
  • GET /api/sites/[siteId] — site detail
  • PUT /api/sites/[siteId] — update config, wall settings, widget customization