API Reference
API reference
The ingest surface is deliberately small: ping, events, snapshots, plus apps statistics for custom rollups. Authenticate with a wp_live_* bearer token from Organization → Developer. Read the Ingest guide for the mental model.
Base URL
Production: https://wepeople.app
Every response includes X-WePeople-API-Version. Errors include a requestId and docsUrl pointing to error codes.
Endpoints
- View →Auth & headers
Bearer tokens, idempotency, CORS, and version header.
- View →GET/api/v1/ingest/ping
Validate a key and echo the app it belongs to.
- View →POST/api/v1/ingest/events
Ingest a batch of timeline events (≤ 100).
- View →POST/api/v1/ingest/snapshots
Replace a worker snapshot card.
- View →GET/PUT/api/v1/apps/statistics
Read or replace the app statistic manifest.
- View →Error codes
Stable error shape and full code table.
- View →OpenAPI & SDK
Machine-readable spec and TypeScript client links.