---
title: "POST /api/internal/desktop/rewards/set-balance"
method: POST
path: "/api/internal/desktop/rewards/set-balance"
tags: ["Desktop"]
---

# POST /api/internal/desktop/rewards/set-balance

`POST /api/internal/desktop/rewards/set-balance`

## Request body

- object
  - `balance` integer, required

## Response `200`

Update the desktop test balance

- object
  - `viewer` object, required
    - `cloudConnected` boolean, required
    - `activeModelId` string, nullable, required
    - `activeModelProviderId` string, nullable, required
    - `usingManagedModel` boolean, required
  - `progress` object, required
    - `claimedCount` integer, required
    - `totalCount` integer, required
    - `earnedCredits` number, required
    - `availableCredits` number
  - `tasks` object[], required
    - `id` 'daily_checkin' | 'github_star' | 'x_share' | 'reddit' | 'mobile_share' | 'lingying' | 'facebook' | 'whatsapp', required
    - `group` 'daily' | 'opensource' | 'social', required
    - `icon` string, required
    - `reward` number, required
    - `shareMode` 'link' | 'tweet' | 'image', required
    - `repeatMode` 'once' | 'daily' | 'weekly', required
    - `requiresScreenshot` boolean, required
    - `actionUrl` string, uri, nullable
    - `isClaimed` boolean, required
    - `lastClaimedAt` string, nullable, required
    - `claimCount` integer, required
  - `cloudBalance` object, nullable
    - `totalBalance` integer, required
    - `totalRecharged` integer, required
    - `totalConsumed` integer, required
    - `giftedBalance` integer
    - `planBalance` integer
  - `autoFallbackTriggered` boolean

## Other responses

- `400` — Unable to update the desktop test balance

---

[API](https://skmtc.net/nexu-io/apis/nexu-controller-api.md) · [All operations](https://skmtc.net/nexu-io/apis/nexu-controller-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nexu-io/nexu-controller-api/versions/ee3237405da6/schema)