---
title: "Create App Rating Event"
method: POST
path: "/app-rating/events"
tags: ["app-rating"]
---

# Create App Rating Event

`POST /app-rating/events`

## Request

- Base URL: `https://api.excellence-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.excellence-ai.com/app-rating/events`
- Auth: OAuth 2 (password, token URL `api/login`)

Answers with the status after the event and the event's delta, so a
result screen knows at once whether it may ask.

## Request body

- AppRatingEventCreate
  - `kind` 'quiz_result' | 'revision_result' | 'homework_result' | 'copy_result' | 'exercise_result' | 'grading_failed', required
  - `platform` 'ios' | 'android', required
  - `ref_id` string, nullable
  - `ratio` number, nullable
  - `item_count` integer, nullable

## Response `200`

Successful Response

- AppRatingEventResponse
  - `eligible` boolean, required
  - `reason` 'not_student' | 'account_too_new' | 'not_active_enough' | 'cooldown' | 'yearly_cap', nullable
  - `score` number, required
  - `ripe_at` string, date-time, nullable
  - `mood_pending` boolean
  - `ready` boolean, required
  - `delta` integer, nullable

## Other responses

- `422`: Validation Error

## Changes

> 55 revisions in range; 1 not diffed.

- **2026-10-21** `1d6009058248`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/excellence-ai/apis/excellence-learning/changes/app-rating/events/post.md)

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) - [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) - [OpenAPI document](https://skmtc.dev/excellence-ai/apis/excellence-learning/revisions/379e4a57dee8?raw)