API reference

OpenAPI specification

The machine-readable description of every /v1 operation and webhook event, and how to use it.

Download

https://limenia.eu/openapi/v1.yaml

The file is OpenAPI 3.0 (YAML). It contains:

  • every /v1 operation with request and response schemas, the error responses and examples,
  • the security scheme apiKey (Authorization: Bearer <API key>),
  • the webhook events under x-webhooks (OpenAPI 3.0 has no webhooks section) with the schemas WebhookEvent and EventType,
  • the server https://app.limenia.eu.

The version in info.version is the API version; the changelog lists what changed.

Operations

Operation Page
GET /v1/ping API basics
POST /v1/reports Reports
PUT /v1/subjects/{externalUserId} Users
GET /v1/subjects/{externalUserId}/status Users
POST /v1/appeals Complaints
GET /v1/appeals/{appealId} Complaints
POST /v1/reviews Pre-moderation reviews
GET /v1/reviews/{reviewId} Pre-moderation reviews
POST /v1/signals Signals
POST /v1/devices/check Device checks
POST /v1/integrations/revenuecat/{tenantId}/{appId} RevenueCat webhook receiver (called by RevenueCat)

Using it

  • Generate a client: see Typed clients from the OpenAPI spec.
  • Validate webhook payloads in tests against WebhookEvent.
  • Give it to a coding agent together with this documentation: https://limenia.eu/llms-full.txt contains both in one file.
  • Exhaustive enums: new enum values (for example a new decision action or event type) can be added within /v1. Generated code must not fail on unknown values (see Versioning).