# Changelog

Changes to the partner-facing API, newest first. PlayerPal is in pre-release: endpoints marked In development can still change. Every route stays under `/v1`.

<Change date="2026-10-15">

### Partner API reference

The [API reference](/api/partner) is now generated from the API's own code, with descriptions for every partner endpoint, request and response schemas, and error codes. The OpenAPI 3.1 document is published at [`/openapi/partner.json`](pathname:///openapi/partner.json).

</Change>

<Change date="2026-10-14">

### Insights

`GET /v1/kpis/intelligence/insights` returns ranked, explainable insights with an executive summary, and `GET /v1/kpis/intelligence/insights/{id}` returns one insight with its evidence. See [Insights](../analytics/insights.mdx).

### Explore endpoints for providers

Segments, journey funnel and per-game views were added under `/v1/kpis/explore`.

</Change>

<Change date="2026-10-13">

### Fact ingest

`POST /v1/ingest` accepts daily fact batches (gameplay, game catalogue, commercial and attribution) with per-record validation and idempotent receipts. See [Fact ingest](./fact-ingest.mdx).

### KPI API

- Own KPIs, breakdowns by market, game or partner, monthly retention cohorts, the link funnel and previous-period series under `/v1/kpis`.
- Anonymous network comparison and peer benchmarks, with peer and account thresholds.
- The partner overview at `GET /v1/kpis/overview` lists every KPI with its availability for your feeds.

### Partner authentication

Partner routes accept PP-HMAC-SHA256 request signing or OAuth 2.0 client-credentials tokens, with scopes. See [Authentication](./authentication.mdx).

</Change>

<Change date="2026-09-17">

### Bulk activity uploads

Large activity files can be sent through `POST /v1/activity-uploads` and completed with a checksum. See [Sending activity](./sending-activity.mdx).

### Studio analytics

Game providers can read studio analytics at `GET /v1/analytics/studio` and per alias.

</Change>

<Change date="2026-09-09">

### Widget releases

The PlayerPal widget is served as immutable, versioned releases with integrity hashes. See [Widget](./widget.mdx).

</Change>

<Change date="2026-09-07">

### Activity batches

`POST /v1/activity-batches` accepts settled rounds for points and analytics, idempotent on `batch_id`.

</Change>