---
title: "Buy a playbook upgrade node"
method: POST
path: "/api/v1/engage/games/locker-singularity/ledger/upgrades"
tags: ["Games", "Game Engine", "Engage"]
---

# Buy a playbook upgrade node

`POST /api/v1/engage/games/locker-singularity/ledger/upgrades`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/v1/engage/games/locker-singularity/ledger/upgrades`
- Auth: HTTP bearer

Unknown nodeId returns 400 VALIDATION_ERROR. Already-owned nodes return 400 VALIDATION_ERROR (stale client state; never the already-played screen). Insufficient Playbooks returns 409 IDLE_INSUFFICIENT_BUZZ. Costs 1-3 Playbooks per the frozen node table. Idempotent per idempotencyKey. Optional X-Client-Version below minClientVersion returns 403 GAME_UPDATE_REQUIRED.

## Headers

- `X-Client-Version` string

## Request body

- object
  - `nodeId` 'locker-room-10' | 'packs-25' | 'hockey-dailies-10' | 'micd-up-25' | 'locker-room-global-5' | 'micd-up-global-5', required
  - `idempotencyKey` string, uuid, required

## Response `200`

{ ledger }

- object
  - `ledger` LedgerState, required: locker-singularity idle ledger wire state. Buzz counters are BigInt serialized as decimal strings. Additive-only wire evolution (d-sports-api#682).
    - `buzz` string, required: BigInt serialized as decimal string.
    - `lifetimeBuzz` string, required: BigInt serialized as decimal string.
    - `cumulativeBuzz` string, required: BigInt serialized as decimal string.
    - `playbooks` integer, required
    - `generators` IdleLedgerGeneratorState[], required
      - `generatorId` 'rookie-card' | 'foam-finger-stand' | 'zamboni-fleet' | 'banner-press', required
      - `owned` integer, required
    - `milestonesClaimed` string[], required
    - `upgrades` string[], required
    - `rings` integer, required: Most recent prestige grant (informational); totalRings is the cumulative balance.
    - `totalRings` integer, required
    - `prestigeCount` integer, required
    - `multiplier` number, required
    - `prestigeUnlocked` boolean, required
    - `version` integer, required
    - `lastSeenAt` string, date-time, required

## Other responses

- `400`: VALIDATION_ERROR
- `401`: UNAUTHORIZED
- `403`: GAME_UPDATE_REQUIRED
- `404`: GAME_UNKNOWN
- `409`: IDLE_INSUFFICIENT_BUZZ

## Changes

- **2026-09-24** `01971acf764b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/v1/engage/games/locker-singularity/ledger/upgrades/post.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
