Platform administration
Independently authorised promotion-code and audit operations.
Platform administrators are provisioned independently from organiser roles. An owner or administrator of an organisation receives no platform access by virtue of that role.
| Operation | Purpose |
|---|---|
GET /api/platform/codes | Promotion and referral codes with tenant, limits, usage, and discount totals. |
GET /api/platform/codes/detail | One code and its redemption history. |
GET /api/platform/audit | Filtered, paginated audit entries with actor, organisation, subject, and concrete JSON metadata. |
All routes require a valid Better Auth session and live platform-administrator
record. Missing identity returns 401; missing platform authority returns 403.
Audit filters are query parameters and page defaults to 1.