# api

## Pages

- [API reference](https://docs.pug.sh/api/index.md) - Call every Pug endpoint with plain JSON over HTTP POST. Base URLs, request format, auth modes and the Connect error model.
- [Events API](https://docs.pug.sh/api/events/index.md) - Ingest event batches with sdk.events.v1.EventsService/BatchCreate - full request schema, property wrapping and validation rules.
- [Insights API](https://docs.pug.sh/api/insights/index.md) - Run trends, funnel, retention, segmentation, user-flow, top-K and map queries programmatically with a private key.
- [Profiles API](https://docs.pug.sh/api/profiles/index.md) - Identify users, read and list profiles, and run data-subject deletion across the SDK and shared profile services.