---
title: "Record App Rating Request"
method: POST
path: "/app-rating/requests"
tags: ["app-rating"]
---

# Record App Rating Request

`POST /app-rating/requests`

## 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/requests`
- Auth: OAuth 2 (password, token URL `api/login`)

## Request body

- AppRatingRequestCreate
  - `trigger` 'result_screen' | 'app_open' | 'resume' | 'left_chat' | 'home', required
  - `platform` 'ios' | 'android', required
  - `screen` string, nullable
  - `native_build_version` string, nullable
  - `ota_bundle_version` string, nullable
  - `prompt` boolean

## Response `200`

Successful Response

- AppRatingRequestResponse
  - `id` string, required
  - `wording` 'tu' | 'vous', nullable
  - `chain_native` boolean, nullable

## Other responses

- `409`: Business rule violated
- `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/requests/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)