---
title: "Spin Wheel"
method: POST
path: "/cabinet/wheel/spin"
tags: ["Fortune Wheel"]
---

# Spin Wheel

`POST /cabinet/wheel/spin`

## Request

- The document declares no server URL.
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/bedolagam/apis/remnawave-bot-admin-api/docs/cabinet/wheel/spin/post.ts> (a function with typed inputs; its response is checked against the schema)

Крутить колесо удачи.

## Request body

- SpinRequest: Запрос на спин.
  - `payment_type` 'telegram_stars' | 'subscription_days', required: Способы оплаты спина.

## Response `200`

Successful Response

- SpinResultResponse: Результат спина.
  - `success` boolean, required
  - `prize_id` integer, nullable
  - `prize_type` string, nullable
  - `prize_value` integer
  - `prize_display_name` string
  - `emoji` string
  - `color` string
  - `rotation_degrees` number
  - `message` string
  - `promocode` string, nullable
  - `error` string, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-03** `2360876ff9c5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bedolagam/apis/remnawave-bot-admin-api/changes/cabinet/wheel/spin/post.md)

---

[API](https://skmtc.dev/bedolagam/apis/remnawave-bot-admin-api.md) - [All operations](https://skmtc.dev/bedolagam/apis/remnawave-bot-admin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bedolagam/apis/remnawave-bot-admin-api/revisions/2360876ff9c5?raw)