> ## Documentation Index
> Fetch the complete documentation index at: https://developers.perkstar.co.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Developer-facing changes to the Perkstar API, SDK, and integration guidance.

## July 2026

### Developer portal

* Added a dedicated guide and generated API reference for integration teams.
* Added production recipes for POS, Odoo, customer sync, webhooks, and wallet pushes.
* Added a security and operational go-live checklist.
* Added the official Python SDK with retries, pagination, typed errors, and webhook verification.
* Added a generated Postman collection and production environment covering all public v1 operations.
* Added a public component status page and machine-readable status endpoint.

### API key safety

* Direct API-key presets no longer include the internal OAuth-only MCP scope.
* MCP access now explicitly requires an OAuth token.
* Test keys cannot mutate customers, enrolments, or webhook configuration.
* Test marketplace accrual is restricted to existing customers and enrolments.
* Direct browser playground calls accept only approved Perkstar developer-portal origins.

### Documentation contract

* Test-mode limitations are now part of the canonical OpenAPI description.
* Documentation navigation and links are validated in CI.
* SDK packages, Postman assets, and OpenAPI operation coverage are validated before release.

## May 2026

* Added the v1 REST API, scoped API keys, OAuth access tokens, cursor pagination, and request tracing.
* Added POS-friendly marketplace ping, accrue, enrol, and reverse endpoints.
* Published the official zero-dependency TypeScript SDK.


## Related topics

- [Versioning and compatibility](/support/versioning.md)