{"openapi":"3.1.0","info":{"title":"Minealyze Public API","version":"0.2.0","description":"Surface publique de l’API Minealyze : les endpoints appelables avec une clé API `mna_` (plus les endpoints de statut). Les routes first-party du tableau de bord (auth par session) ne sont pas listées ici car une clé API ne peut pas les appeler."},"servers":[{"url":"https://api.minealyze.com"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Session Better Auth (cookie ou Bearer token). Les endpoints à portée organisation exigent AUSSI l'en-tête X-Organization-Id."},"apiKeyAuth":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"Clé API à portée serveur (ingestion plugin, §25.9)."}},"schemas":{"ApiError":{"type":"object","properties":{"statusCode":{"type":"integer","minimum":400,"maximum":599},"error":{"type":"string"},"message":{"type":"string"},"code":{"type":"string"}},"required":["statusCode","error","message"]},"Entitlements":{"type":"object","properties":{"plan":{"type":"string","enum":["free","starter","pro","network","hosting"]},"historyDays":{"anyOf":[{"type":"integer","minimum":0},{"type":"string","enum":["unlimited"]}]},"maxServers":{"anyOf":[{"type":"integer","minimum":0},{"type":"string","enum":["unlimited"]}]},"nlQueriesPerMonth":{"anyOf":[{"type":"integer","minimum":0},{"type":"string","enum":["unlimited"]}]},"maxModelTier":{"type":"string","enum":["haiku","sonnet","opus"]},"opusTasksPerMonth":{"anyOf":[{"type":"integer","minimum":0},{"type":"string","enum":["unlimited"]}]},"byokAvailable":{"type":"boolean"},"dataFreshness":{"type":"string","enum":["daily_batch","near_realtime","realtime"]},"exportLevel":{"type":"string","enum":["csv_manual","programmatic","api","api_fleet"]},"winbackCampaignsPerMonth":{"anyOf":[{"type":"integer","minimum":0},{"type":"string","enum":["unlimited"]}]},"features":{"type":"object","properties":{"watchlist":{"type":"boolean"},"watchlistLockedTeaser":{"type":"boolean"},"churnExplained":{"type":"boolean"},"cohortAutopsy":{"type":"boolean"},"winback":{"type":"boolean"},"semiAuto":{"type":"boolean"},"holdout":{"type":"string","enum":["none","basic","full"]},"dailyBrief":{"type":"boolean"},"weeklyBriefing":{"type":"boolean"},"alerting":{"type":"boolean"}},"required":["watchlist","watchlistLockedTeaser","churnExplained","cohortAutopsy","winback","semiAuto","holdout","dailyBrief","weeklyBriefing","alerting"]}},"required":["plan","historyDays","maxServers","nlQueriesPerMonth","maxModelTier","opusTasksPerMonth","byokAvailable","dataFreshness","exportLevel","winbackCampaignsPerMonth","features"]},"Plan":{"type":"object","properties":{"id":{"type":"string","enum":["free","starter","pro","network","hosting"]},"name":{"type":"string","minLength":1},"pricePerMonthEur":{"type":["number","null"],"minimum":0},"entitlements":{"type":"object","properties":{"plan":{"type":"string","enum":["free","starter","pro","network","hosting"]},"historyDays":{"anyOf":[{"type":"integer","minimum":0},{"type":"string","enum":["unlimited"]}]},"maxServers":{"anyOf":[{"type":"integer","minimum":0},{"type":"string","enum":["unlimited"]}]},"nlQueriesPerMonth":{"anyOf":[{"type":"integer","minimum":0},{"type":"string","enum":["unlimited"]}]},"maxModelTier":{"type":"string","enum":["haiku","sonnet","opus"]},"opusTasksPerMonth":{"anyOf":[{"type":"integer","minimum":0},{"type":"string","enum":["unlimited"]}]},"byokAvailable":{"type":"boolean"},"dataFreshness":{"type":"string","enum":["daily_batch","near_realtime","realtime"]},"exportLevel":{"type":"string","enum":["csv_manual","programmatic","api","api_fleet"]},"winbackCampaignsPerMonth":{"anyOf":[{"type":"integer","minimum":0},{"type":"string","enum":["unlimited"]}]},"features":{"type":"object","properties":{"watchlist":{"type":"boolean"},"watchlistLockedTeaser":{"type":"boolean"},"churnExplained":{"type":"boolean"},"cohortAutopsy":{"type":"boolean"},"winback":{"type":"boolean"},"semiAuto":{"type":"boolean"},"holdout":{"type":"string","enum":["none","basic","full"]},"dailyBrief":{"type":"boolean"},"weeklyBriefing":{"type":"boolean"},"alerting":{"type":"boolean"}},"required":["watchlist","watchlistLockedTeaser","churnExplained","cohortAutopsy","winback","semiAuto","holdout","dailyBrief","weeklyBriefing","alerting"]}},"required":["plan","historyDays","maxServers","nlQueriesPerMonth","maxModelTier","opusTasksPerMonth","byokAvailable","dataFreshness","exportLevel","winbackCampaignsPerMonth","features"]}},"required":["id","name","pricePerMonthEur","entitlements"]},"PlansResponse":{"type":"object","properties":{"plans":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","enum":["free","starter","pro","network","hosting"]},"name":{"type":"string","minLength":1},"pricePerMonthEur":{"type":["number","null"],"minimum":0},"entitlements":{"type":"object","properties":{"plan":{"type":"string","enum":["free","starter","pro","network","hosting"]},"historyDays":{"anyOf":[{"type":"integer","minimum":0},{"type":"string","enum":["unlimited"]}]},"maxServers":{"anyOf":[{"type":"integer","minimum":0},{"type":"string","enum":["unlimited"]}]},"nlQueriesPerMonth":{"anyOf":[{"type":"integer","minimum":0},{"type":"string","enum":["unlimited"]}]},"maxModelTier":{"type":"string","enum":["haiku","sonnet","opus"]},"opusTasksPerMonth":{"anyOf":[{"type":"integer","minimum":0},{"type":"string","enum":["unlimited"]}]},"byokAvailable":{"type":"boolean"},"dataFreshness":{"type":"string","enum":["daily_batch","near_realtime","realtime"]},"exportLevel":{"type":"string","enum":["csv_manual","programmatic","api","api_fleet"]},"winbackCampaignsPerMonth":{"anyOf":[{"type":"integer","minimum":0},{"type":"string","enum":["unlimited"]}]},"features":{"type":"object","properties":{"watchlist":{"type":"boolean"},"watchlistLockedTeaser":{"type":"boolean"},"churnExplained":{"type":"boolean"},"cohortAutopsy":{"type":"boolean"},"winback":{"type":"boolean"},"semiAuto":{"type":"boolean"},"holdout":{"type":"string","enum":["none","basic","full"]},"dailyBrief":{"type":"boolean"},"weeklyBriefing":{"type":"boolean"},"alerting":{"type":"boolean"}},"required":["watchlist","watchlistLockedTeaser","churnExplained","cohortAutopsy","winback","semiAuto","holdout","dailyBrief","weeklyBriefing","alerting"]}},"required":["plan","historyDays","maxServers","nlQueriesPerMonth","maxModelTier","opusTasksPerMonth","byokAvailable","dataFreshness","exportLevel","winbackCampaignsPerMonth","features"]}},"required":["id","name","pricePerMonthEur","entitlements"]}}},"required":["plans"]},"CheckoutRequest":{"type":"object","properties":{"planId":{"type":"string","enum":["starter","pro","network"]},"successUrl":{"type":"string","format":"uri"},"cancelUrl":{"type":"string","format":"uri"}},"required":["planId","successUrl","cancelUrl"]},"CheckoutResponse":{"type":"object","properties":{"checkoutUrl":{"type":"string","format":"uri"},"checkoutSessionId":{"type":"string","minLength":1}},"required":["checkoutUrl","checkoutSessionId"]},"Subscription":{"type":"object","properties":{"id":{"type":"string","minLength":1},"planId":{"type":"string","enum":["free","starter","pro","network","hosting"]},"status":{"type":"string","enum":["active","trialing","past_due","canceled","incomplete","incomplete_expired","unpaid","paused"]},"currentPeriodEnd":{"type":["string","null"],"format":"date-time"},"cancelAtPeriodEnd":{"type":"boolean"},"stripeCustomerId":{"type":["string","null"]},"stripeSubscriptionId":{"type":["string","null"]}},"required":["id","planId","status","currentPeriodEnd","cancelAtPeriodEnd","stripeCustomerId","stripeSubscriptionId"]},"StripeWebhookEvent":{"type":"object","properties":{"id":{"type":"string"},"object":{"type":"string","enum":["event"]},"api_version":{"type":["string","null"]},"created":{"type":"integer"},"livemode":{"type":"boolean"},"type":{"type":"string","minLength":1},"data":{"type":"object","properties":{"object":{"type":"object","additionalProperties":{}},"previous_attributes":{"type":"object","additionalProperties":{}}},"required":["object"]}},"required":["id","object","created","livemode","type","data"]},"WebhookAck":{"type":"object","properties":{"received":{"type":"boolean","enum":[true]}},"required":["received"]},"TebexWebhook":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["validation.webhook","payment.completed","payment.declined","payment.refunded","payment.dispute.opened","payment.dispute.won","payment.dispute.lost","payment.dispute.closed","recurring-payment.started","recurring-payment.renewed","recurring-payment.ended","recurring-payment.cancellation.requested","recurring-payment.cancellation.aborted"]},"date":{"type":"string"},"subject":{"type":"object","additionalProperties":{}}},"required":["id","type","date","subject"]},"TebexValidationResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"}},"required":["id"]},"SignupRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"email":{"type":"string","format":"email"},"password":{"type":"string","minLength":8,"maxLength":128}},"required":["name","email","password"]},"LoginRequest":{"type":"object","properties":{"email":{"type":"string","format":"email"},"password":{"type":"string","minLength":1,"maxLength":128},"rememberMe":{"type":"boolean"}},"required":["email","password"]},"AuthResponse":{"type":"object","properties":{"user":{"type":"object","properties":{"id":{"type":"string","minLength":1},"email":{"type":"string","format":"email"},"name":{"type":"string"},"emailVerified":{"type":"boolean"},"image":{"type":["string","null"],"format":"uri"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","email","name","emailVerified","createdAt","updatedAt"]},"token":{"type":"string","minLength":1}},"required":["user","token"]},"AuthUser":{"type":"object","properties":{"id":{"type":"string","minLength":1},"email":{"type":"string","format":"email"},"name":{"type":"string"},"emailVerified":{"type":"boolean"},"image":{"type":["string","null"],"format":"uri"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","email","name","emailVerified","createdAt","updatedAt"]},"ApiKeyCreateRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"serverId":{"type":"string","minLength":1,"maxLength":64}},"required":["name","serverId"]},"ApiKeyCreateResponse":{"type":"object","properties":{"apiKey":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"},"serverId":{"type":"string","minLength":1,"maxLength":64},"prefix":{"type":"string"},"start":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"lastUsedAt":{"type":["string","null"],"format":"date-time"},"revoked":{"type":"boolean"},"revokedAt":{"type":["string","null"],"format":"date-time"},"revokedReason":{"type":["string","null"]}},"required":["id","name","serverId","prefix","createdAt","lastUsedAt","revoked"]},"key":{"type":"string","minLength":1}},"required":["apiKey","key"]},"ApiKeysListResponse":{"type":"object","properties":{"apiKeys":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"},"serverId":{"type":"string","minLength":1,"maxLength":64},"prefix":{"type":"string"},"start":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"lastUsedAt":{"type":["string","null"],"format":"date-time"},"revoked":{"type":"boolean"},"revokedAt":{"type":["string","null"],"format":"date-time"},"revokedReason":{"type":["string","null"]}},"required":["id","name","serverId","prefix","createdAt","lastUsedAt","revoked"]}}},"required":["apiKeys"]},"ApiKeyRevokeRequest":{"type":"object","properties":{"reason":{"type":"string","minLength":1,"maxLength":300}}},"ApiKeyRevokeResponse":{"type":"object","properties":{"apiKey":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"},"serverId":{"type":"string","minLength":1,"maxLength":64},"prefix":{"type":"string"},"start":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"lastUsedAt":{"type":["string","null"],"format":"date-time"},"revoked":{"type":"boolean"},"revokedAt":{"type":["string","null"],"format":"date-time"},"revokedReason":{"type":["string","null"]}},"required":["id","name","serverId","prefix","createdAt","lastUsedAt","revoked"]}},"required":["apiKey"]},"ApiKeyRotateResponse":{"type":"object","properties":{"apiKey":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"},"serverId":{"type":"string","minLength":1,"maxLength":64},"prefix":{"type":"string"},"start":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"},"lastUsedAt":{"type":["string","null"],"format":"date-time"},"revoked":{"type":"boolean"},"revokedAt":{"type":["string","null"],"format":"date-time"},"revokedReason":{"type":["string","null"]}},"required":["id","name","serverId","prefix","createdAt","lastUsedAt","revoked"]},"key":{"type":"string","minLength":1},"revokedKeyId":{"type":"string","minLength":1}},"required":["apiKey","key","revokedKeyId"]},"TebexConnectionResponse":{"type":"object","properties":{"connection":{"type":["object","null"],"properties":{"id":{"type":"string","format":"uuid"},"storeName":{"type":["string","null"]},"storeIdent":{"type":["string","null"]},"status":{"type":"string","enum":["pending","active","error","disabled"]},"webhookUrl":{"type":"string","minLength":1},"lastWebhookAt":{"type":["string","null"],"format":"date-time"},"lastVerifiedAt":{"type":["string","null"],"format":"date-time"},"lastErrorAt":{"type":["string","null"],"format":"date-time"},"lastErrorMessage":{"type":["string","null"]},"createdAt":{"type":"string","format":"date-time"}},"required":["id","storeName","storeIdent","status","webhookUrl","lastWebhookAt","lastVerifiedAt","lastErrorAt","lastErrorMessage","createdAt"]}},"required":["connection"]},"TebexConnectionUpsertRequest":{"type":"object","properties":{"secret":{"type":"string","minLength":8,"maxLength":200},"storeName":{"type":"string","minLength":1,"maxLength":120},"storeIdent":{"type":"string","minLength":1,"maxLength":120}},"required":["secret"]},"PluginEvent":{"oneOf":[{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"playerUuid":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["session_start"]},"world":{"type":"string"}},"required":["eventId","occurredAt","playerUuid","type"]},{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"playerUuid":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["session_end"]},"durationSeconds":{"type":"integer","minimum":0},"afkSeconds":{"type":"integer","minimum":0},"world":{"type":"string"}},"required":["eventId","occurredAt","playerUuid","type","durationSeconds"]},{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"playerUuid":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["first_milestone"]},"milestone":{"type":"string","enum":["first_join","first_move","first_block","first_chat","first_command","first_claim"]}},"required":["eventId","occurredAt","playerUuid","type","milestone"]},{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"playerUuid":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["block_place","block_break"]},"world":{"type":"string"},"material":{"type":"string"},"count":{"type":"integer","exclusiveMinimum":0,"default":1}},"required":["eventId","occurredAt","playerUuid","type"]},{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"playerUuid":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["chat_message"]},"messageLength":{"type":"integer","minimum":0},"mentionCount":{"type":"integer","minimum":0,"default":0}},"required":["eventId","occurredAt","playerUuid","type","messageLength"]},{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"playerUuid":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["social_proximity"]},"otherPlayerUuid":{"type":"string","format":"uuid"},"durationSeconds":{"type":"integer","minimum":0}},"required":["eventId","occurredAt","playerUuid","type","otherPlayerUuid","durationSeconds"]},{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"playerUuid":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["player_death"]},"isPvp":{"type":"boolean"},"cause":{"type":"string"}},"required":["eventId","occurredAt","playerUuid","type","isPvp"]},{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"playerUuid":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["advancement"]},"advancementKey":{"type":"string"}},"required":["eventId","occurredAt","playerUuid","type","advancementKey"]},{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"playerUuid":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["rank_up"]},"fromRank":{"type":"string"},"toRank":{"type":"string"}},"required":["eventId","occurredAt","playerUuid","type","toRank"]},{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"playerUuid":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["economy_transaction"]},"amount":{"type":"number"},"balanceAfter":{"type":"number"},"source":{"type":"string","enum":["vault","shop_buy","shop_sell","other"],"default":"vault"}},"required":["eventId","occurredAt","playerUuid","type","amount"]},{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"playerUuid":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["balance_snapshot"]},"balance":{"type":"number"}},"required":["eventId","occurredAt","playerUuid","type","balance"]},{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"playerUuid":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["vote"]},"serviceName":{"type":"string"}},"required":["eventId","occurredAt","playerUuid","type","serviceName"]},{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"type":{"type":"string","enum":["server_heartbeat"]},"tps":{"type":"number","minimum":0,"maximum":20},"msptAvg":{"type":"number","minimum":0},"cpuPercent":{"type":"number","minimum":0,"maximum":100},"ramUsedMb":{"type":"number","minimum":0},"onlinePlayers":{"type":"integer","minimum":0}},"required":["eventId","occurredAt","type","tps","onlinePlayers"]}]},"PhoneHomeBatch":{"type":"object","properties":{"batchId":{"type":"string","format":"uuid"},"serverId":{"type":"string","minLength":1,"maxLength":64},"pluginVersion":{"type":"string","minLength":1},"minecraftVersion":{"type":"string"},"sentAt":{"type":"string","format":"date-time"},"events":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"playerUuid":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["session_start"]},"world":{"type":"string"}},"required":["eventId","occurredAt","playerUuid","type"]},{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"playerUuid":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["session_end"]},"durationSeconds":{"type":"integer","minimum":0},"afkSeconds":{"type":"integer","minimum":0},"world":{"type":"string"}},"required":["eventId","occurredAt","playerUuid","type","durationSeconds"]},{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"playerUuid":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["first_milestone"]},"milestone":{"type":"string","enum":["first_join","first_move","first_block","first_chat","first_command","first_claim"]}},"required":["eventId","occurredAt","playerUuid","type","milestone"]},{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"playerUuid":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["block_place","block_break"]},"world":{"type":"string"},"material":{"type":"string"},"count":{"type":"integer","exclusiveMinimum":0,"default":1}},"required":["eventId","occurredAt","playerUuid","type"]},{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"playerUuid":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["chat_message"]},"messageLength":{"type":"integer","minimum":0},"mentionCount":{"type":"integer","minimum":0,"default":0}},"required":["eventId","occurredAt","playerUuid","type","messageLength"]},{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"playerUuid":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["social_proximity"]},"otherPlayerUuid":{"type":"string","format":"uuid"},"durationSeconds":{"type":"integer","minimum":0}},"required":["eventId","occurredAt","playerUuid","type","otherPlayerUuid","durationSeconds"]},{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"playerUuid":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["player_death"]},"isPvp":{"type":"boolean"},"cause":{"type":"string"}},"required":["eventId","occurredAt","playerUuid","type","isPvp"]},{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"playerUuid":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["advancement"]},"advancementKey":{"type":"string"}},"required":["eventId","occurredAt","playerUuid","type","advancementKey"]},{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"playerUuid":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["rank_up"]},"fromRank":{"type":"string"},"toRank":{"type":"string"}},"required":["eventId","occurredAt","playerUuid","type","toRank"]},{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"playerUuid":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["economy_transaction"]},"amount":{"type":"number"},"balanceAfter":{"type":"number"},"source":{"type":"string","enum":["vault","shop_buy","shop_sell","other"],"default":"vault"}},"required":["eventId","occurredAt","playerUuid","type","amount"]},{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"playerUuid":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["balance_snapshot"]},"balance":{"type":"number"}},"required":["eventId","occurredAt","playerUuid","type","balance"]},{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"playerUuid":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["vote"]},"serviceName":{"type":"string"}},"required":["eventId","occurredAt","playerUuid","type","serviceName"]},{"type":"object","properties":{"eventId":{"type":"string","format":"uuid"},"occurredAt":{"type":"string","format":"date-time"},"type":{"type":"string","enum":["server_heartbeat"]},"tps":{"type":"number","minimum":0,"maximum":20},"msptAvg":{"type":"number","minimum":0},"cpuPercent":{"type":"number","minimum":0,"maximum":100},"ramUsedMb":{"type":"number","minimum":0},"onlinePlayers":{"type":"integer","minimum":0}},"required":["eventId","occurredAt","type","tps","onlinePlayers"]}]},"minItems":1,"maxItems":500},"droppedEvents":{"type":"integer","minimum":0,"default":0}},"required":["batchId","serverId","pluginVersion","sentAt","events"]},"PhoneHomeAck":{"type":"object","properties":{"batchId":{"type":"string","format":"uuid"},"accepted":{"type":"integer","minimum":0},"rejected":{"type":"integer","minimum":0},"pendingActions":{"type":"array","items":{"type":"object","properties":{"actionId":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["dispatch_command","broadcast","discord_webhook"]},"command":{"type":"string"},"message":{"type":"string"},"targetPlayerUuid":{"type":"string","format":"uuid"},"idempotencyKey":{"type":"string","minLength":1},"expiresAt":{"type":"string","format":"date-time"}},"required":["actionId","kind","idempotencyKey","expiresAt"]},"default":[]},"update":{"type":"object","properties":{"alg":{"type":"string","enum":["ed25519-v1"]},"keyId":{"type":"string","pattern":"^[0-9A-Za-z._-]{1,32}$"},"version":{"type":"string","pattern":"^[0-9A-Za-z.+-]{1,64}$"},"filename":{"type":"string","pattern":"^(?=.{1,64}$)[0-9A-Za-z._-]*\\.jar$"},"size":{"type":"integer","exclusiveMinimum":0,"maximum":33554432},"sha256":{"type":"string","pattern":"^[0-9a-f]{64}$"},"url":{"type":"string","format":"uri","pattern":"^https:\\/\\/"},"signature":{"type":"string","minLength":64,"maxLength":128}},"required":["alg","keyId","version","filename","size","sha256","url","signature"]}},"required":["batchId","accepted","rejected"]},"PluginAction":{"type":"object","properties":{"actionId":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["dispatch_command","broadcast","discord_webhook"]},"command":{"type":"string"},"message":{"type":"string"},"targetPlayerUuid":{"type":"string","format":"uuid"},"idempotencyKey":{"type":"string","minLength":1},"expiresAt":{"type":"string","format":"date-time"}},"required":["actionId","kind","idempotencyKey","expiresAt"]},"PluginActionResultsRequest":{"type":"array","items":{"type":"object","properties":{"actionId":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["executed","expired","failed","rejected"]},"executedAt":{"type":"string","format":"date-time"},"errorMessage":{"type":"string","maxLength":500}},"required":["actionId","status"]},"minItems":1,"maxItems":100},"PluginActionResultsAck":{"type":"object","properties":{"recorded":{"type":"integer","minimum":0},"ignored":{"type":"integer","minimum":0}},"required":["recorded","ignored"]},"DescriptiveOverviewResponse":{"type":"object","properties":{"serverId":{"type":"string","minLength":1,"maxLength":64},"period":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"}},"required":["from","to"]},"dau":{"type":"integer","minimum":0},"mau":{"type":"integer","minimum":0},"stickiness":{"type":"number","minimum":0,"maximum":1},"sessions":{"type":"object","properties":{"count":{"type":"integer","minimum":0},"medianDurationMinutes":{"type":"number","minimum":0}},"required":["count","medianDurationMinutes"]},"retention":{"type":"object","properties":{"d1":{"type":["number","null"],"minimum":0,"maximum":1},"d7":{"type":["number","null"],"minimum":0,"maximum":1},"d30":{"type":["number","null"],"minimum":0,"maximum":1}},"required":["d1","d7","d30"]},"punchcard":{"type":"array","items":{"type":"object","properties":{"dayOfWeek":{"type":"integer","minimum":0,"maximum":6},"hour":{"type":"integer","minimum":0,"maximum":23},"sessions":{"type":"integer","minimum":0}},"required":["dayOfWeek","hour","sessions"]}},"healthScore":{"type":"object","properties":{"score":{"type":"number","minimum":0,"maximum":100},"components":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"score":{"type":"number","minimum":0,"maximum":100}},"required":["name","score"]},"minItems":1,"maxItems":7}},"required":["score","components"]},"performance":{"type":"object","properties":{"tpsAvg":{"type":"number","minimum":0,"maximum":20},"msptAvg":{"type":"number","minimum":0},"cpuPercent":{"type":"number","minimum":0,"maximum":100},"ramUsedMb":{"type":"number","minimum":0}},"required":["tpsAvg"]},"countries":{"type":"array","items":{"type":"object","properties":{"countryCode":{"type":"string","minLength":2,"maxLength":2},"players":{"type":"integer","minimum":0}},"required":["countryCode","players"]}}},"required":["serverId","period","dau","mau","stickiness","sessions","retention","punchcard","healthScore","performance","countries"]},"WatchlistResponse":{"type":"object","properties":{"serverId":{"type":"string","minLength":1,"maxLength":64},"generatedAt":{"type":"string","format":"date-time"},"locked":{"type":"boolean"},"atRiskCount":{"type":"integer","minimum":0},"payersAtRiskCount":{"type":"integer","minimum":0},"entries":{"type":"array","items":{"type":"object","properties":{"playerUuid":{"type":"string","format":"uuid"},"playerName":{"type":"string"},"isPayer":{"type":"boolean"},"segment":{"type":"string","enum":["champions","potential_loyalists","new","at_risk","cant_lose_them","hibernating"]},"riskScore":{"type":"number","minimum":0,"maximum":1},"dominantFactor":{"type":"string","minLength":1},"ltv":{"type":["object","null"],"properties":{"amountCents":{"type":"integer"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amountCents","currency"]},"confidence":{"type":"string","enum":["high","medium","low"]},"suggestedAction":{"type":"object","properties":{"kind":{"type":"string","enum":["winback_campaign","discord_alert","ingame_reward","none"]},"label":{"type":"string","minLength":1},"campaignTemplateId":{"type":"string"}},"required":["kind","label"]}},"required":["playerUuid","isPayer","segment","riskScore","dominantFactor","ltv","confidence","suggestedAction"]}}},"required":["serverId","generatedAt","locked","atRiskCount","payersAtRiskCount","entries"]},"ChurnExplanationResponse":{"type":"object","properties":{"serverId":{"type":"string","minLength":1,"maxLength":64},"playerUuid":{"type":"string","format":"uuid"},"score":{"type":"number","minimum":0,"maximum":1},"confidence":{"type":"string","enum":["high","medium","low"]},"windowDays":{"type":"integer","exclusiveMinimum":0},"churnDefinition":{"type":"string","minLength":1},"dominantFactors":{"type":"array","items":{"type":"object","properties":{"feature":{"type":"string","minLength":1},"description":{"type":"string","minLength":1},"value":{"type":"number"},"contribution":{"type":"number"}},"required":["feature","description","value","contribution"]},"minItems":1,"maxItems":3},"narrative":{"type":"string"},"aiWriting":{"type":"object","properties":{"used":{"type":"boolean"},"model":{"type":"string"},"unavailableReason":{"type":"string","enum":["api_key_missing","insufficient_data","llm_unavailable","refusal"]},"notice":{"type":"string","minLength":1}},"required":["used","notice"]},"modelVersion":{"type":"string","minLength":1}},"required":["serverId","playerUuid","score","confidence","windowDays","churnDefinition","dominantFactors","modelVersion"]},"CohortRetentionResponse":{"type":"object","properties":{"serverId":{"type":"string","minLength":1,"maxLength":64},"source":{"type":"string"},"rows":{"type":"array","items":{"type":"object","properties":{"cohortDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"size":{"type":"integer","minimum":0},"d1":{"type":["number","null"],"minimum":0,"maximum":1},"d7":{"type":["number","null"],"minimum":0,"maximum":1},"d30":{"type":["number","null"],"minimum":0,"maximum":1}},"required":["cohortDate","size","d1","d7","d30"]}}},"required":["serverId","rows"]},"CohortAutopsyResponse":{"type":"object","properties":{"serverId":{"type":"string","minLength":1,"maxLength":64},"period":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"}},"required":["from","to"]},"insufficientData":{"type":"boolean"},"causes":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer","minimum":1,"maximum":3},"statement":{"type":"string","minLength":1},"metric":{"type":"string","minLength":1},"churnedValue":{"type":"number"},"retainedValue":{"type":"number"},"ratio":{"type":"number"},"significant":{"type":"boolean"},"confidence":{"type":"string","enum":["high","medium","low"]},"suggestedAction":{"type":"object","properties":{"kind":{"type":"string","enum":["winback_campaign","discord_alert","ingame_reward","none"]},"label":{"type":"string","minLength":1},"campaignTemplateId":{"type":"string"}},"required":["kind","label"]}},"required":["rank","statement","metric","churnedValue","retainedValue","ratio","significant","confidence"]},"maxItems":3},"narrative":{"type":"string"}},"required":["serverId","period","insufficientData","causes"]},"LiftReport":{"type":"object","properties":{"campaignId":{"type":"string","minLength":1},"metric":{"type":"string","enum":["retention_d7","retention_d30","revenue"]},"liftAbsolute":{"type":"number"},"targetSize":{"type":"integer","minimum":0},"holdoutSize":{"type":"integer","minimum":0},"significant":{"type":"boolean"},"retainedRevenue":{"type":"object","properties":{"amountCents":{"type":"integer"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amountCents","currency"]}},"required":["campaignId","metric","liftAbsolute","targetSize","holdoutSize","significant"]},"DailyBriefResponse":{"type":"object","properties":{"serverId":{"type":"string","minLength":1,"maxLength":64},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"priority":{"type":"integer","minimum":1},"title":{"type":"string","minLength":1},"body":{"type":"string","minLength":1},"confidence":{"type":"string","enum":["high","medium","low"]},"action":{"type":"object","properties":{"kind":{"type":"string","enum":["winback_campaign","discord_alert","ingame_reward","none"]},"label":{"type":"string","minLength":1},"campaignTemplateId":{"type":"string"}},"required":["kind","label"]}},"required":["id","priority","title","body","confidence"]},"maxItems":5}},"required":["serverId","date","items"]},"WeeklyBriefingResponse":{"type":"object","properties":{"serverId":{"type":"string","minLength":1,"maxLength":64},"weekStart":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"narrativeMarkdown":{"type":"string","minLength":1},"aiWriting":{"type":"object","properties":{"used":{"type":"boolean"},"model":{"type":"string"},"unavailableReason":{"type":"string","enum":["api_key_missing","insufficient_data","llm_unavailable","refusal"]},"notice":{"type":"string","minLength":1}},"required":["used","notice"]},"citedMetrics":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"}},"required":["label","value"]}},"autopsy":{"type":"object","properties":{"serverId":{"type":"string","minLength":1,"maxLength":64},"period":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"}},"required":["from","to"]},"insufficientData":{"type":"boolean"},"causes":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"integer","minimum":1,"maximum":3},"statement":{"type":"string","minLength":1},"metric":{"type":"string","minLength":1},"churnedValue":{"type":"number"},"retainedValue":{"type":"number"},"ratio":{"type":"number"},"significant":{"type":"boolean"},"confidence":{"type":"string","enum":["high","medium","low"]},"suggestedAction":{"type":"object","properties":{"kind":{"type":"string","enum":["winback_campaign","discord_alert","ingame_reward","none"]},"label":{"type":"string","minLength":1},"campaignTemplateId":{"type":"string"}},"required":["kind","label"]}},"required":["rank","statement","metric","churnedValue","retainedValue","ratio","significant","confidence"]},"maxItems":3},"narrative":{"type":"string"}},"required":["serverId","period","insufficientData","causes"]},"liftReports":{"type":"array","items":{"type":"object","properties":{"campaignId":{"type":"string","minLength":1},"metric":{"type":"string","enum":["retention_d7","retention_d30","revenue"]},"liftAbsolute":{"type":"number"},"targetSize":{"type":"integer","minimum":0},"holdoutSize":{"type":"integer","minimum":0},"significant":{"type":"boolean"},"retainedRevenue":{"type":"object","properties":{"amountCents":{"type":"integer"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amountCents","currency"]}},"required":["campaignId","metric","liftAbsolute","targetSize","holdoutSize","significant"]}},"recommendedActions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"priority":{"type":"integer","minimum":1},"title":{"type":"string","minLength":1},"body":{"type":"string","minLength":1},"confidence":{"type":"string","enum":["high","medium","low"]},"action":{"type":"object","properties":{"kind":{"type":"string","enum":["winback_campaign","discord_alert","ingame_reward","none"]},"label":{"type":"string","minLength":1},"campaignTemplateId":{"type":"string"}},"required":["kind","label"]}},"required":["id","priority","title","body","confidence"]},"maxItems":3}},"required":["serverId","weekStart","narrativeMarkdown","aiWriting","citedMetrics","liftReports","recommendedActions"]},"Campaign":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"serverId":{"type":"string","format":"uuid"},"name":{"type":"string"},"status":{"type":"string","enum":["draft","preview","confirmed","running","completed","cancelled"]},"targetSegment":{"type":["string","null"]},"channel":{"type":"string"},"offer":{"type":"object","additionalProperties":{}},"messageVariants":{"type":"array","items":{"type":"string"}},"holdoutPct":{"type":"number"},"confirmedAt":{"type":["string","null"],"format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"actionStats":{"type":"object","properties":{"total":{"type":"integer","minimum":0},"pending":{"type":"integer","minimum":0},"delivered":{"type":"integer","minimum":0},"executed":{"type":"integer","minimum":0},"failed":{"type":"integer","minimum":0},"expired":{"type":"integer","minimum":0}},"required":["total","pending","delivered","executed","failed","expired"]}},"required":["id","serverId","name","status","targetSegment","channel","offer","messageVariants","holdoutPct","confirmedAt","startedAt","createdAt"]},"CampaignCreateRequest":{"type":"object","properties":{"serverId":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":120},"targetSegment":{"type":"string","enum":["champions","potential_loyalists","new","at_risk","cant_lose_them","hibernating"]},"channel":{"type":"string","enum":["discord_webhook","in_game_command"]},"offer":{"type":"object","properties":{"kind":{"type":"string","enum":["in_game_reward","discord_message","coupon"]},"description":{"type":"string","minLength":1,"maxLength":300},"commandTemplate":{"type":"string","maxLength":300},"nonP2wChecked":{"type":"boolean"}},"required":["kind","description","nonP2wChecked"]},"holdoutPct":{"type":"number","minimum":0.05,"maximum":0.9},"frequencyCapDays":{"type":"integer","exclusiveMinimum":0,"maximum":90},"minSegmentSize":{"type":"integer","exclusiveMinimum":0,"maximum":10000}},"required":["serverId","name","targetSegment","channel","offer"]},"CampaignsListResponse":{"type":"object","properties":{"campaigns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"serverId":{"type":"string","format":"uuid"},"name":{"type":"string"},"status":{"type":"string","enum":["draft","preview","confirmed","running","completed","cancelled"]},"targetSegment":{"type":["string","null"]},"channel":{"type":"string"},"offer":{"type":"object","additionalProperties":{}},"messageVariants":{"type":"array","items":{"type":"string"}},"holdoutPct":{"type":"number"},"confirmedAt":{"type":["string","null"],"format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"actionStats":{"type":"object","properties":{"total":{"type":"integer","minimum":0},"pending":{"type":"integer","minimum":0},"delivered":{"type":"integer","minimum":0},"executed":{"type":"integer","minimum":0},"failed":{"type":"integer","minimum":0},"expired":{"type":"integer","minimum":0}},"required":["total","pending","delivered","executed","failed","expired"]}},"required":["id","serverId","name","status","targetSegment","channel","offer","messageVariants","holdoutPct","confirmedAt","startedAt","createdAt"]}}},"required":["campaigns"]},"CampaignPreviewResponse":{"type":"object","properties":{"campaign":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"serverId":{"type":"string","format":"uuid"},"name":{"type":"string"},"status":{"type":"string","enum":["draft","preview","confirmed","running","completed","cancelled"]},"targetSegment":{"type":["string","null"]},"channel":{"type":"string"},"offer":{"type":"object","additionalProperties":{}},"messageVariants":{"type":"array","items":{"type":"string"}},"holdoutPct":{"type":"number"},"confirmedAt":{"type":["string","null"],"format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"actionStats":{"type":"object","properties":{"total":{"type":"integer","minimum":0},"pending":{"type":"integer","minimum":0},"delivered":{"type":"integer","minimum":0},"executed":{"type":"integer","minimum":0},"failed":{"type":"integer","minimum":0},"expired":{"type":"integer","minimum":0}},"required":["total","pending","delivered","executed","failed","expired"]}},"required":["id","serverId","name","status","targetSegment","channel","offer","messageVariants","holdoutPct","confirmedAt","startedAt","createdAt"]},"preview":{"type":"object","properties":{"targetCount":{"type":"integer","minimum":0},"treatmentCount":{"type":"integer","minimum":0},"controlCount":{"type":"integer","minimum":0},"holdoutPct":{"type":"number"},"realizedControlFraction":{"type":"number"},"variants":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string"},"action":{"type":"string"},"citedData":{"type":"array","items":{"type":"string"}}},"required":["message","action"]}},"aiWriting":{"type":"object","properties":{"used":{"type":"boolean"},"model":{"type":"string"},"unavailableReason":{"type":"string","enum":["api_key_missing","insufficient_data","llm_unavailable","refusal"]},"notice":{"type":"string","minLength":1}},"required":["used","notice"]},"offer":{"type":"object","additionalProperties":{}},"nonP2wChecked":{"type":"boolean"}},"required":["targetCount","treatmentCount","controlCount","holdoutPct","realizedControlFraction","variants","offer","nonP2wChecked"]}},"required":["campaign","preview"]},"CampaignConfirmResponse":{"type":"object","properties":{"campaign":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"serverId":{"type":"string","format":"uuid"},"name":{"type":"string"},"status":{"type":"string","enum":["draft","preview","confirmed","running","completed","cancelled"]},"targetSegment":{"type":["string","null"]},"channel":{"type":"string"},"offer":{"type":"object","additionalProperties":{}},"messageVariants":{"type":"array","items":{"type":"string"}},"holdoutPct":{"type":"number"},"confirmedAt":{"type":["string","null"],"format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"actionStats":{"type":"object","properties":{"total":{"type":"integer","minimum":0},"pending":{"type":"integer","minimum":0},"delivered":{"type":"integer","minimum":0},"executed":{"type":"integer","minimum":0},"failed":{"type":"integer","minimum":0},"expired":{"type":"integer","minimum":0}},"required":["total","pending","delivered","executed","failed","expired"]}},"required":["id","serverId","name","status","targetSegment","channel","offer","messageVariants","holdoutPct","confirmedAt","startedAt","createdAt"]},"holdout":{"type":"object","properties":{"treatmentCount":{"type":"integer","minimum":0},"controlCount":{"type":"integer","minimum":0}},"required":["treatmentCount","controlCount"]},"actions":{"type":"object","properties":{"created":{"type":"integer","minimum":0},"skippedFrequencyCap":{"type":"integer","minimum":0},"skippedOptOut":{"type":"integer","minimum":0}},"required":["created","skippedFrequencyCap","skippedOptOut"]}},"required":["campaign","holdout"]},"CopilotQueryRequest":{"type":"object","properties":{"serverId":{"type":"string","format":"uuid"},"message":{"type":"string","minLength":1,"maxLength":2000},"history":{"type":"array","items":{"type":"object","properties":{"role":{"type":"string","enum":["user","assistant"]},"content":{"type":"string","minLength":1,"maxLength":4000}},"required":["role","content"]},"maxItems":12}},"required":["serverId","message"]},"CopilotQueryResponse":{"type":"object","properties":{"answer":{"type":["string","null"]},"citedData":{"type":"array","items":{"type":"string"}},"confidence":{"type":["number","null"],"minimum":0,"maximum":1},"sources":{"type":"array","items":{"type":"object","properties":{"view":{"type":"string"},"params":{"type":"object","additionalProperties":{}},"rowCount":{"type":"integer","minimum":0}},"required":["view","params","rowCount"]}},"tables":{"type":"array","items":{"type":"object","properties":{"view":{"type":"string"},"title":{"type":"string"},"columns":{"type":"array","items":{"type":"string"}},"rows":{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"null"}]}}},"truncated":{"type":"boolean"}},"required":["view","title","columns","rows","truncated"]}},"aiWriting":{"type":"object","properties":{"used":{"type":"boolean"},"model":{"type":"string"},"unavailableReason":{"type":"string","enum":["api_key_missing","insufficient_data","llm_unavailable","refusal"]},"notice":{"type":"string","minLength":1}},"required":["used","notice"]},"proposal":{"type":["object","null"],"properties":{"action":{"type":"string","enum":["winback_campaign"]},"targetSegment":{"type":"string","enum":["champions","potential_loyalists","new","at_risk","cant_lose_them","hibernating"]},"channel":{"type":"string","enum":["discord_webhook","in_game_command"]},"offer":{"type":"object","properties":{"kind":{"type":"string","enum":["in_game_reward","discord_message","coupon"]},"description":{"type":"string","minLength":1,"maxLength":300},"commandTemplate":{"type":"string","maxLength":300}},"required":["kind","description"]},"holdoutPct":{"type":"number","minimum":0.05,"maximum":0.9},"rationale":{"type":"string","maxLength":500}},"required":["action","targetSegment","channel","offer","holdoutPct","rationale"]},"clarification":{"type":["string","null"]},"quota":{"type":"object","properties":{"used":{"type":"integer","minimum":0},"limit":{"anyOf":[{"type":"integer","minimum":0},{"type":"string","enum":["unlimited"]}]}},"required":["used","limit"]}},"required":["answer","citedData","confidence","sources","tables","aiWriting","proposal","clarification","quota"]},"CopilotQuota":{"type":"object","properties":{"used":{"type":"integer","minimum":0},"limit":{"anyOf":[{"type":"integer","minimum":0},{"type":"string","enum":["unlimited"]}]}},"required":["used","limit"]},"CopilotActionPreviewRequest":{"type":"object","properties":{"serverId":{"type":"string","format":"uuid"},"proposal":{"type":"object","properties":{"action":{"type":"string","enum":["winback_campaign"]},"targetSegment":{"type":"string","enum":["champions","potential_loyalists","new","at_risk","cant_lose_them","hibernating"]},"channel":{"type":"string","enum":["discord_webhook","in_game_command"]},"offer":{"type":"object","properties":{"kind":{"type":"string","enum":["in_game_reward","discord_message","coupon"]},"description":{"type":"string","minLength":1,"maxLength":300},"commandTemplate":{"type":"string","maxLength":300}},"required":["kind","description"]},"holdoutPct":{"type":"number","minimum":0.05,"maximum":0.9},"rationale":{"type":"string","maxLength":500}},"required":["action","targetSegment","channel","offer","holdoutPct","rationale"]}},"required":["serverId","proposal"]},"CopilotActionPreviewResponse":{"type":"object","properties":{"campaignId":{"type":"string","format":"uuid"},"campaignName":{"type":"string"},"preview":{"type":"object","properties":{"targetCount":{"type":"integer","minimum":0},"treatmentCount":{"type":"integer","minimum":0},"controlCount":{"type":"integer","minimum":0},"holdoutPct":{"type":"number"},"realizedControlFraction":{"type":"number"},"variants":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string"},"action":{"type":"string"},"citedData":{"type":"array","items":{"type":"string"}}},"required":["message","action"]}},"aiWriting":{"type":"object","properties":{"used":{"type":"boolean"},"model":{"type":"string"},"unavailableReason":{"type":"string","enum":["api_key_missing","insufficient_data","llm_unavailable","refusal"]},"notice":{"type":"string","minLength":1}},"required":["used","notice"]},"offer":{"type":"object","additionalProperties":{}},"nonP2wChecked":{"type":"boolean"}},"required":["targetCount","treatmentCount","controlCount","holdoutPct","realizedControlFraction","variants","offer","nonP2wChecked"]}},"required":["campaignId","campaignName","preview"]},"CopilotActionConfirmRequest":{"type":"object","properties":{"campaignId":{"type":"string","format":"uuid"}},"required":["campaignId"]},"CopilotActionConfirmResponse":{"type":"object","properties":{"campaign":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"serverId":{"type":"string","format":"uuid"},"name":{"type":"string"},"status":{"type":"string","enum":["draft","preview","confirmed","running","completed","cancelled"]},"targetSegment":{"type":["string","null"]},"channel":{"type":"string"},"offer":{"type":"object","additionalProperties":{}},"messageVariants":{"type":"array","items":{"type":"string"}},"holdoutPct":{"type":"number"},"confirmedAt":{"type":["string","null"],"format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"actionStats":{"type":"object","properties":{"total":{"type":"integer","minimum":0},"pending":{"type":"integer","minimum":0},"delivered":{"type":"integer","minimum":0},"executed":{"type":"integer","minimum":0},"failed":{"type":"integer","minimum":0},"expired":{"type":"integer","minimum":0}},"required":["total","pending","delivered","executed","failed","expired"]}},"required":["id","serverId","name","status","targetSegment","channel","offer","messageVariants","holdoutPct","confirmedAt","startedAt","createdAt"]},"holdout":{"type":"object","properties":{"treatmentCount":{"type":"integer","minimum":0},"controlCount":{"type":"integer","minimum":0}},"required":["treatmentCount","controlCount"]},"actions":{"type":"object","properties":{"created":{"type":"integer","minimum":0},"skippedFrequencyCap":{"type":"integer","minimum":0},"skippedOptOut":{"type":"integer","minimum":0}},"required":["created","skippedFrequencyCap","skippedOptOut"]}},"required":["campaign","holdout"]},"Server":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"type":{"type":"string","example":"paper"},"mcVersion":{"type":["string","null"]},"connected":{"type":"boolean"},"lastSeenAt":{"type":["string","null"],"format":"date-time"}},"required":["id","name","type","mcVersion","connected","lastSeenAt"]},"ServerCreateRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"type":{"type":"string","enum":["paper","purpur","folia"]},"mcVersion":{"type":"string","minLength":1,"maxLength":20}},"required":["name","type"]},"ServersResponse":{"type":"object","properties":{"servers":{"type":"array","items":{"$ref":"#/components/schemas/Server"}}},"required":["servers"]},"RescoreResult":{"type":"object","properties":{"computedDate":{"type":"string","example":"2026-07-15"},"playersScored":{"type":"integer","minimum":0},"rfmRows":{"type":"integer","minimum":0},"churnRows":{"type":"integer","minimum":0},"watchlistRows":{"type":"integer","minimum":0},"payersAtRisk":{"type":"integer","minimum":0},"durationMs":{"type":"integer","minimum":0}},"required":["computedDate","playersScored","rfmRows","churnRows","watchlistRows","payersAtRisk","durationMs"]},"SubscriptionResponse":{"type":"object","properties":{"subscription":{"allOf":[{"$ref":"#/components/schemas/Subscription"},{"type":["object","null"]}]}},"required":["subscription"]},"PortalRequest":{"type":"object","properties":{"returnUrl":{"type":"string","format":"uri"}},"required":["returnUrl"]},"PortalResponse":{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"required":["url"]},"TebexEventAck":{"type":"object","properties":{"received":{"type":"boolean"},"recorded":{"type":"boolean"}},"required":["received","recorded"]},"ExportCreateRequest":{"type":"object","properties":{"serverId":{"type":"string","minLength":1,"maxLength":64},"resource":{"type":"string","enum":["players","sessions","events","cohorts","watchlist","lift"]},"format":{"type":"string","enum":["csv","json"],"default":"csv"},"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"}},"required":["serverId","resource"]},"ExportJob":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"serverId":{"type":["string","null"],"format":"uuid"},"resource":{"type":"string","enum":["players","sessions","events","cohorts","watchlist","lift"]},"format":{"type":"string","enum":["csv","json"]},"status":{"type":"string","enum":["pending","running","completed","failed","expired"]},"params":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"}}},"rowCount":{"type":["integer","null"],"minimum":0},"fileSizeBytes":{"type":["integer","null"],"minimum":0},"errorMessage":{"type":["string","null"]},"downloadPath":{"type":["string","null"]},"expiresAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","serverId","resource","format","status","params","rowCount","fileSizeBytes","errorMessage","downloadPath","expiresAt","createdAt","startedAt","completedAt"]},"ExportJobsListResponse":{"type":"object","properties":{"jobs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"serverId":{"type":["string","null"],"format":"uuid"},"resource":{"type":"string","enum":["players","sessions","events","cohorts","watchlist","lift"]},"format":{"type":"string","enum":["csv","json"]},"status":{"type":"string","enum":["pending","running","completed","failed","expired"]},"params":{"type":"object","properties":{"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"}}},"rowCount":{"type":["integer","null"],"minimum":0},"fileSizeBytes":{"type":["integer","null"],"minimum":0},"errorMessage":{"type":["string","null"]},"downloadPath":{"type":["string","null"]},"expiresAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"startedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","serverId","resource","format","status","params","rowCount","fileSizeBytes","errorMessage","downloadPath","expiresAt","createdAt","startedAt","completedAt"]}}},"required":["jobs"]},"PlanImportReport":{"type":"object","properties":{"serverId":{"type":"string","format":"uuid"},"planServerUuid":{"type":"string"},"planServerName":{"type":["string","null"]},"players":{"type":"object","properties":{"created":{"type":"integer","minimum":0},"merged":{"type":"integer","minimum":0},"total":{"type":"integer","minimum":0}},"required":["created","merged","total"]},"sessions":{"type":"object","properties":{"imported":{"type":"integer","minimum":0},"skippedDuplicates":{"type":"integer","minimum":0},"skippedInvalid":{"type":"integer","minimum":0}},"required":["imported","skippedDuplicates","skippedInvalid"]},"ignored":{"type":"object","additionalProperties":{"type":"integer","minimum":0}},"pseudonymized":{"type":"boolean","enum":[true]},"durationMs":{"type":"integer","minimum":0}},"required":["serverId","planServerUuid","planServerName","players","sessions","ignored","pseudonymized","durationMs"]},"PlanImportServerOption":{"type":"object","properties":{"uuid":{"type":"string"},"name":{"type":["string","null"]},"isProxy":{"type":"boolean"},"users":{"type":"integer","minimum":0},"sessions":{"type":"integer","minimum":0}},"required":["uuid","name","isProxy","users","sessions"]},"InvitationPublic":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"email":{"type":"string","format":"email"},"role":{"type":"string","enum":["owner","admin","staff","read_only"]},"status":{"type":"string","enum":["pending","expired","accepted","revoked"]},"organizationId":{"type":"string","minLength":1},"organizationName":{"type":"string"},"inviterName":{"type":"string"},"expiresAt":{"type":"string","format":"date-time"}},"required":["id","email","role","status","organizationId","organizationName","inviterName","expiresAt"]},"InvitationNotFound":{"type":"object","properties":{"error":{"type":"string","enum":["not_found"]}},"required":["error"]},"FunnelResponse":{"type":"object","properties":{"serverId":{"type":"string","minLength":1,"maxLength":64},"generatedAt":{"type":"string","format":"date-time"},"windowSeconds":{"type":"integer","exclusiveMinimum":0},"retentionWindowDays":{"type":"integer","exclusiveMinimum":0},"cohortSize":{"type":"integer","minimum":0},"matureCohortSize":{"type":"integer","minimum":0},"minCohortSize":{"type":"integer","exclusiveMinimum":0},"retainedRate":{"type":["number","null"],"minimum":0,"maximum":1},"steps":{"type":"array","items":{"type":"object","properties":{"milestone":{"type":"string","minLength":1},"reached":{"type":"integer","minimum":0},"reachedWithinWindow":{"type":"integer","minimum":0},"conversionFromCohort":{"type":"number","minimum":0,"maximum":1},"conversionFromPrevious":{"type":"number","minimum":0,"maximum":1},"dropOffFromPrevious":{"type":"number","minimum":0,"maximum":1},"medianSecondsToReach":{"type":["integer","null"],"minimum":0}},"required":["milestone","reached","reachedWithinWindow","conversionFromCohort","conversionFromPrevious","dropOffFromPrevious","medianSecondsToReach"]}},"ahaMilestone":{"type":["string","null"]},"ahaCorrelation":{"type":["number","null"],"minimum":-1,"maximum":1},"computedAt":{"type":["string","null"],"format":"date-time"},"abstention":{"type":["string","null"],"enum":["not_computed_yet","insufficient_cohort","no_variance","no_positive_correlation"]},"prescription":{"type":["object","null"],"properties":{"kind":{"type":"string","enum":["push_milestone_earlier"]},"milestone":{"type":"string","minLength":1},"targetSeconds":{"type":"integer","exclusiveMinimum":0},"currentMedianSeconds":{"type":["integer","null"],"minimum":0},"retainedWithRate":{"type":["number","null"],"minimum":0,"maximum":1},"retainedWithoutRate":{"type":["number","null"],"minimum":0,"maximum":1},"suggestedCampaign":{"type":"object","properties":{"targetSegment":{"type":"string","enum":["new"]},"channel":{"type":"string","enum":["in_game_command","discord_webhook"]}},"required":["targetSegment","channel"]}},"required":["kind","milestone","targetSeconds","currentMedianSeconds","retainedWithRate","retainedWithoutRate","suggestedCampaign"]}},"required":["serverId","generatedAt","windowSeconds","retentionWindowDays","cohortSize","matureCohortSize","minCohortSize","retainedRate","steps","ahaMilestone","ahaCorrelation","computedAt","abstention","prescription"]},"Anomaly":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"serverId":{"type":"string","minLength":1,"maxLength":64},"metric":{"type":"string","minLength":1},"detector":{"type":"string","enum":["zscore","ewma","iqr"]},"severity":{"type":"string","enum":["info","warning","critical"]},"status":{"type":"string","enum":["open","acknowledged","resolved","dismissed"]},"observedValue":{"type":"number"},"baselineValue":{"type":["number","null"]},"deviation":{"type":"number"},"direction":{"type":"string","enum":["up","down"]},"windowStart":{"type":"string","format":"date-time"},"windowEnd":{"type":"string","format":"date-time"},"confidence":{"type":"number","minimum":0,"maximum":1},"detectors":{"type":"array","items":{"type":"string","enum":["zscore","ewma","iqr"]},"minItems":1},"probableCause":{"type":"string","minLength":1},"suggestedActions":{"type":"array","items":{"type":"string","minLength":1},"minItems":2,"maxItems":3},"acknowledgedBy":{"type":["string","null"]},"acknowledgedAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":"string","format":"date-time"}},"required":["id","serverId","metric","detector","severity","status","observedValue","baselineValue","deviation","direction","windowStart","windowEnd","confidence","detectors","probableCause","suggestedActions","acknowledgedBy","acknowledgedAt","createdAt"]},"AnomaliesListResponse":{"type":"object","properties":{"serverId":{"type":"string","minLength":1,"maxLength":64},"generatedAt":{"type":"string","format":"date-time"},"anomalies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"serverId":{"type":"string","minLength":1,"maxLength":64},"metric":{"type":"string","minLength":1},"detector":{"type":"string","enum":["zscore","ewma","iqr"]},"severity":{"type":"string","enum":["info","warning","critical"]},"status":{"type":"string","enum":["open","acknowledged","resolved","dismissed"]},"observedValue":{"type":"number"},"baselineValue":{"type":["number","null"]},"deviation":{"type":"number"},"direction":{"type":"string","enum":["up","down"]},"windowStart":{"type":"string","format":"date-time"},"windowEnd":{"type":"string","format":"date-time"},"confidence":{"type":"number","minimum":0,"maximum":1},"detectors":{"type":"array","items":{"type":"string","enum":["zscore","ewma","iqr"]},"minItems":1},"probableCause":{"type":"string","minLength":1},"suggestedActions":{"type":"array","items":{"type":"string","minLength":1},"minItems":2,"maxItems":3},"acknowledgedBy":{"type":["string","null"]},"acknowledgedAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":"string","format":"date-time"}},"required":["id","serverId","metric","detector","severity","status","observedValue","baselineValue","deviation","direction","windowStart","windowEnd","confidence","detectors","probableCause","suggestedActions","acknowledgedBy","acknowledgedAt","createdAt"]}},"falsePositiveStats":{"type":"object","properties":{"total":{"type":"integer","minimum":0},"open":{"type":"integer","minimum":0},"acknowledged":{"type":"integer","minimum":0},"resolved":{"type":"integer","minimum":0},"dismissed":{"type":"integer","minimum":0},"dismissedRate":{"type":["number","null"],"minimum":0,"maximum":1}},"required":["total","open","acknowledged","resolved","dismissed","dismissedRate"]},"config":{"type":"object","properties":{"zThreshold":{"type":"number","minimum":1.5,"maximum":10},"ewmaThreshold":{"type":"number","minimum":1.5,"maximum":10},"ewmaAlpha":{"type":"number","minimum":0.05,"maximum":0.9},"iqrK":{"type":"number","minimum":1,"maximum":10},"minPoints":{"type":"integer","minimum":5,"maximum":60},"baselineDays":{"type":"integer","minimum":7,"maximum":90},"recentDays":{"type":"integer","minimum":1,"maximum":14},"disabledMetrics":{"type":"array","items":{"type":"string","enum":["money_supply","economy_volume","event_volume","chargebacks","shop_price_level"]}}},"required":["zThreshold","ewmaThreshold","ewmaAlpha","iqrK","minPoints","baselineDays","recentDays","disabledMetrics"]}},"required":["serverId","generatedAt","anomalies","falsePositiveStats","config"]},"AnomalyDetectionConfig":{"type":"object","properties":{"zThreshold":{"type":"number","minimum":1.5,"maximum":10},"ewmaThreshold":{"type":"number","minimum":1.5,"maximum":10},"ewmaAlpha":{"type":"number","minimum":0.05,"maximum":0.9},"iqrK":{"type":"number","minimum":1,"maximum":10},"minPoints":{"type":"integer","minimum":5,"maximum":60},"baselineDays":{"type":"integer","minimum":7,"maximum":90},"recentDays":{"type":"integer","minimum":1,"maximum":14},"disabledMetrics":{"type":"array","items":{"type":"string","enum":["money_supply","economy_volume","event_volume","chargebacks","shop_price_level"]}}},"required":["zThreshold","ewmaThreshold","ewmaAlpha","iqrK","minPoints","baselineDays","recentDays","disabledMetrics"]},"AnomalyConfigUpdateRequest":{"type":"object","properties":{"zThreshold":{"type":"number","minimum":1.5,"maximum":10},"ewmaThreshold":{"type":"number","minimum":1.5,"maximum":10},"ewmaAlpha":{"type":"number","minimum":0.05,"maximum":0.9},"iqrK":{"type":"number","minimum":1,"maximum":10},"minPoints":{"type":"integer","minimum":5,"maximum":60},"baselineDays":{"type":"integer","minimum":7,"maximum":90},"recentDays":{"type":"integer","minimum":1,"maximum":14},"disabledMetrics":{"type":"array","items":{"type":"string","enum":["money_supply","economy_volume","event_volume","chargebacks","shop_price_level"]}}}},"AnomalyStatusUpdateRequest":{"type":"object","properties":{"status":{"type":"string","enum":["open","acknowledged","resolved","dismissed"]}},"required":["status"]},"AutomationRule":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"serverId":{"type":"string","format":"uuid"},"name":{"type":"string"},"targetSegment":{"type":"string"},"channel":{"type":"string"},"actionTemplate":{"type":"object","properties":{"offer":{"type":"object","properties":{"kind":{"type":"string","enum":["in_game_reward","discord_message","coupon"]},"description":{"type":"string","minLength":1,"maxLength":300},"commandTemplate":{"type":"string","maxLength":300},"nonP2wChecked":{"type":"boolean"}},"required":["kind","description","nonP2wChecked"]},"costPerActionCents":{"type":"integer","minimum":0}},"required":["offer"]},"enabled":{"type":"boolean"},"armed":{"type":"boolean"},"killSwitched":{"type":"boolean"},"killSwitchedAt":{"type":["string","null"],"format":"date-time"},"armedAt":{"type":["string","null"],"format":"date-time"},"frequencyCapDays":{"type":"integer"},"maxActionsPerMonth":{"type":["integer","null"]},"monthlyBudgetCents":{"type":["integer","null"]},"holdoutPct":{"type":"number"},"minSegmentSize":{"type":"integer"},"lastRunAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"monthUsage":{"type":"object","properties":{"actionsCreated":{"type":"integer","minimum":0},"costCents":{"type":"integer","minimum":0},"runs":{"type":"integer","minimum":0}},"required":["actionsCreated","costCents","runs"]}},"required":["id","serverId","name","targetSegment","channel","actionTemplate","enabled","armed","killSwitched","killSwitchedAt","armedAt","frequencyCapDays","maxActionsPerMonth","monthlyBudgetCents","holdoutPct","minSegmentSize","lastRunAt","createdAt","monthUsage"]},"AutomationRulesListResponse":{"type":"object","properties":{"rules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"serverId":{"type":"string","format":"uuid"},"name":{"type":"string"},"targetSegment":{"type":"string"},"channel":{"type":"string"},"actionTemplate":{"type":"object","properties":{"offer":{"type":"object","properties":{"kind":{"type":"string","enum":["in_game_reward","discord_message","coupon"]},"description":{"type":"string","minLength":1,"maxLength":300},"commandTemplate":{"type":"string","maxLength":300},"nonP2wChecked":{"type":"boolean"}},"required":["kind","description","nonP2wChecked"]},"costPerActionCents":{"type":"integer","minimum":0}},"required":["offer"]},"enabled":{"type":"boolean"},"armed":{"type":"boolean"},"killSwitched":{"type":"boolean"},"killSwitchedAt":{"type":["string","null"],"format":"date-time"},"armedAt":{"type":["string","null"],"format":"date-time"},"frequencyCapDays":{"type":"integer"},"maxActionsPerMonth":{"type":["integer","null"]},"monthlyBudgetCents":{"type":["integer","null"]},"holdoutPct":{"type":"number"},"minSegmentSize":{"type":"integer"},"lastRunAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"monthUsage":{"type":"object","properties":{"actionsCreated":{"type":"integer","minimum":0},"costCents":{"type":"integer","minimum":0},"runs":{"type":"integer","minimum":0}},"required":["actionsCreated","costCents","runs"]}},"required":["id","serverId","name","targetSegment","channel","actionTemplate","enabled","armed","killSwitched","killSwitchedAt","armedAt","frequencyCapDays","maxActionsPerMonth","monthlyBudgetCents","holdoutPct","minSegmentSize","lastRunAt","createdAt","monthUsage"]}}},"required":["rules"]},"AutomationRuleCreateRequest":{"type":"object","properties":{"serverId":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":120},"targetSegment":{"type":"string","enum":["champions","potential_loyalists","new","at_risk","cant_lose_them","hibernating"]},"channel":{"type":"string","enum":["discord_webhook","in_game_command"]},"actionTemplate":{"type":"object","properties":{"offer":{"type":"object","properties":{"kind":{"type":"string","enum":["in_game_reward","discord_message","coupon"]},"description":{"type":"string","minLength":1,"maxLength":300},"commandTemplate":{"type":"string","maxLength":300},"nonP2wChecked":{"type":"boolean"}},"required":["kind","description","nonP2wChecked"]},"costPerActionCents":{"type":"integer","minimum":0}},"required":["offer"]},"frequencyCapDays":{"type":"integer","minimum":1,"maximum":90,"default":7},"maxActionsPerMonth":{"type":["integer","null"],"minimum":1,"maximum":100000},"monthlyBudgetCents":{"type":["integer","null"],"minimum":0},"holdoutPct":{"type":"number","minimum":0.1,"maximum":0.5,"default":0.2},"minSegmentSize":{"type":"integer","minimum":1,"maximum":10000}},"required":["serverId","name","targetSegment","channel","actionTemplate"]},"AutomationRuleUpdateRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"targetSegment":{"type":"string","enum":["champions","potential_loyalists","new","at_risk","cant_lose_them","hibernating"]},"channel":{"type":"string","enum":["discord_webhook","in_game_command"]},"actionTemplate":{"type":"object","properties":{"offer":{"type":"object","properties":{"kind":{"type":"string","enum":["in_game_reward","discord_message","coupon"]},"description":{"type":"string","minLength":1,"maxLength":300},"commandTemplate":{"type":"string","maxLength":300},"nonP2wChecked":{"type":"boolean"}},"required":["kind","description","nonP2wChecked"]},"costPerActionCents":{"type":"integer","minimum":0}},"required":["offer"]},"frequencyCapDays":{"type":"integer","minimum":1,"maximum":90},"maxActionsPerMonth":{"type":["integer","null"],"minimum":1,"maximum":100000},"monthlyBudgetCents":{"type":["integer","null"],"minimum":0},"holdoutPct":{"type":"number","minimum":0.1,"maximum":0.5},"minSegmentSize":{"type":"integer","minimum":1,"maximum":10000}}},"AutomationKillResponse":{"type":"object","properties":{"rule":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"serverId":{"type":"string","format":"uuid"},"name":{"type":"string"},"targetSegment":{"type":"string"},"channel":{"type":"string"},"actionTemplate":{"type":"object","properties":{"offer":{"type":"object","properties":{"kind":{"type":"string","enum":["in_game_reward","discord_message","coupon"]},"description":{"type":"string","minLength":1,"maxLength":300},"commandTemplate":{"type":"string","maxLength":300},"nonP2wChecked":{"type":"boolean"}},"required":["kind","description","nonP2wChecked"]},"costPerActionCents":{"type":"integer","minimum":0}},"required":["offer"]},"enabled":{"type":"boolean"},"armed":{"type":"boolean"},"killSwitched":{"type":"boolean"},"killSwitchedAt":{"type":["string","null"],"format":"date-time"},"armedAt":{"type":["string","null"],"format":"date-time"},"frequencyCapDays":{"type":"integer"},"maxActionsPerMonth":{"type":["integer","null"]},"monthlyBudgetCents":{"type":["integer","null"]},"holdoutPct":{"type":"number"},"minSegmentSize":{"type":"integer"},"lastRunAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"monthUsage":{"type":"object","properties":{"actionsCreated":{"type":"integer","minimum":0},"costCents":{"type":"integer","minimum":0},"runs":{"type":"integer","minimum":0}},"required":["actionsCreated","costCents","runs"]}},"required":["id","serverId","name","targetSegment","channel","actionTemplate","enabled","armed","killSwitched","killSwitchedAt","armedAt","frequencyCapDays","maxActionsPerMonth","monthlyBudgetCents","holdoutPct","minSegmentSize","lastRunAt","createdAt","monthUsage"]},"actionsCancelled":{"type":"integer","minimum":0},"campaignsCancelled":{"type":"integer","minimum":0}},"required":["rule","actionsCancelled","campaignsCancelled"]},"AutomationRunsListResponse":{"type":"object","properties":{"runs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"ruleId":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["success","skipped","failed","rolled_back"]},"campaignId":{"type":["string","null"],"format":"uuid"},"actionsCreated":{"type":"integer","minimum":0},"detail":{"type":"object","additionalProperties":{}},"startedAt":{"type":"string","format":"date-time"},"finishedAt":{"type":["string","null"],"format":"date-time"},"rolledBackAt":{"type":["string","null"],"format":"date-time"}},"required":["id","ruleId","status","campaignId","actionsCreated","detail","startedAt","finishedAt","rolledBackAt"]}}},"required":["runs"]},"AutomationRollbackResponse":{"type":"object","properties":{"run":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"ruleId":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["success","skipped","failed","rolled_back"]},"campaignId":{"type":["string","null"],"format":"uuid"},"actionsCreated":{"type":"integer","minimum":0},"detail":{"type":"object","additionalProperties":{}},"startedAt":{"type":"string","format":"date-time"},"finishedAt":{"type":["string","null"],"format":"date-time"},"rolledBackAt":{"type":["string","null"],"format":"date-time"}},"required":["id","ruleId","status","campaignId","actionsCreated","detail","startedAt","finishedAt","rolledBackAt"]},"actionsCancelled":{"type":"integer","minimum":0},"actionsAlreadyExecuted":{"type":"integer","minimum":0}},"required":["run","actionsCancelled","actionsAlreadyExecuted"]},"BenchmarkOptIn":{"type":"object","properties":{"optedIn":{"type":"boolean"}},"required":["optedIn"]},"BenchmarkResponse":{"type":"object","properties":{"serverId":{"type":"string","format":"uuid"},"optedIn":{"type":"boolean"},"metrics":{"type":"array","items":{"type":"object","properties":{"metric":{"type":"string","enum":["retention_d7","stickiness","median_session_minutes","arpu_cents","payer_share","at_risk_share"]},"yourValue":{"type":["number","null"]},"sampleSize":{"type":"integer","minimum":0},"requiredSampleSize":{"type":"integer","exclusiveMinimum":0},"insufficientData":{"type":"boolean"},"percentiles":{"type":"object","properties":{"p10":{"type":["number","null"]},"p25":{"type":["number","null"]},"p50":{"type":"number"},"p75":{"type":["number","null"]},"p90":{"type":["number","null"]},"mean":{"type":["number","null"]}},"required":["p10","p25","p50","p75","p90","mean"]},"periodStart":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"periodEnd":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"computedAt":{"type":"string","format":"date-time"}},"required":["metric","yourValue","sampleSize","requiredSampleSize","insufficientData"]}},"notice":{"type":"string"}},"required":["serverId","optedIn","metrics","notice"]},"GdprRetention":{"type":"object","properties":{"eventRetentionMonths":{"type":"integer","minimum":1,"maximum":36},"maxMonthsForPlan":{"type":"integer","minimum":1,"maximum":36}},"required":["eventRetentionMonths","maxMonthsForPlan"]},"GdprRetentionUpdate":{"type":"object","properties":{"eventRetentionMonths":{"type":"integer","minimum":1,"maximum":36}},"required":["eventRetentionMonths"]},"GdprRequest":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["export","deletion"]},"subjectKind":{"type":"string","enum":["player","organization"]},"serverId":{"type":["string","null"],"format":"uuid"},"playerId":{"type":["string","null"],"format":"uuid"},"subjectUuidHash":{"type":["string","null"]},"status":{"type":"string","enum":["pending","processing","completed","rejected","failed"]},"notes":{"type":["string","null"]},"result":{"type":"object","additionalProperties":{}},"hasExportFile":{"type":"boolean"},"processedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":"string","format":"date-time"}},"required":["id","kind","subjectKind","serverId","playerId","subjectUuidHash","status","notes","result","hasExportFile","processedAt","completedAt","createdAt"]},"GdprRequestCreate":{"type":"object","properties":{"kind":{"type":"string","enum":["export","deletion"]},"subjectKind":{"type":"string","enum":["player","organization"]},"serverId":{"type":"string","format":"uuid"},"playerId":{"type":"string","format":"uuid"},"notes":{"type":"string","maxLength":500}},"required":["kind","subjectKind"]},"GdprRequestsResponse":{"type":"object","properties":{"requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["export","deletion"]},"subjectKind":{"type":"string","enum":["player","organization"]},"serverId":{"type":["string","null"],"format":"uuid"},"playerId":{"type":["string","null"],"format":"uuid"},"subjectUuidHash":{"type":["string","null"]},"status":{"type":"string","enum":["pending","processing","completed","rejected","failed"]},"notes":{"type":["string","null"]},"result":{"type":"object","additionalProperties":{}},"hasExportFile":{"type":"boolean"},"processedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":"string","format":"date-time"}},"required":["id","kind","subjectKind","serverId","playerId","subjectUuidHash","status","notes","result","hasExportFile","processedAt","completedAt","createdAt"]}}},"required":["requests"]}},"parameters":{}},"paths":{"/health":{"get":{"tags":["health"],"summary":"Liveness","responses":{"200":{"description":"Service vivant","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["ok"]}},"required":["status"]}}}}}}},"/health/ready":{"get":{"tags":["health"],"summary":"Readiness (vérifie l’accès à la base)","responses":{"200":{"description":"Service prêt","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["ready"]}},"required":["status"]}}}},"503":{"description":"Base de données indisponible","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/ingest":{"post":{"tags":["plugin"],"summary":"Batch d'events phone-home (idempotent par batchId, max 500 events)","description":"Endpoint appelé par le plugin Minecraft. Corps JSON, `Content-Encoding: gzip` supporté (défaut du plugin). L'ACK transporte les `pendingActions` des campagnes confirmées pour ce serveur (canal de retour d’action), et, si une version du collecteur strictement plus récente que le `pluginVersion` du batch est publiée, un bloc `update` signé Ed25519 (annonce de mise à jour automatique — le champ est absent le reste du temps, et les plugins antérieurs l’ignorent).","security":[{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhoneHomeBatch"}}}},"responses":{"202":{"description":"Batch accepté + actions en attente pour ce serveur","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhoneHomeAck"}}}},"400":{"description":"Requête invalide","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Non authentifié","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/ingest/action-results":{"post":{"tags":["plugin"],"summary":"Accusés d'exécution des actions livrées dans l'ACK (idempotent : un accusé répété est ignoré)","security":[{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PluginActionResultsRequest"}}}},"responses":{"200":{"description":"Résultats journalisés (audit) / ignorés (déjà accusés ou hors tenant)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PluginActionResultsAck"}}}},"400":{"description":"Requête invalide","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Non authentifié","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}}},"webhooks":{}}