---
title: "Edit card value tables"
method: PUT
path: "/api/admin/card-value"
tags: ["Admin", "Collectibles and packs"]
---

# Edit card value tables

`PUT /api/admin/card-value`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/admin/card-value`
- Auth: HTTP bearer

Platform admin or superadmin only (isPlatformAdmin). All writes run in one transaction, followed by a settings reread. Platform scope: integer rarity bases 0-1000000 and/or moment factors rounded to 2 decimal places before checking the stored range 0.1-10 (for example 0.095 stores 0.1 and 10.004 stores 10); teamId is forbidden. Team scope: nonblank teamId (id or slug) and rarity bases; null deletes an override and restores platform fallback, including when already absent. momentFactors is forbidden in team scope. At least one map entry is required. Unknown rarity/moment map keys are rejected; unrecognized top-level fields are ignored. Responses are private, no-store.

## Request body

- union
  - union
    - object
      - `scope` 'platform', required
      - `rarityBases` object, required
        - `COMMON` integer
        - `RARE` integer
        - `EPIC` integer
        - `LEGENDARY` integer
        - `MYTHIC` integer
      - `momentFactors` object
        - `PORTRAIT` number: Rounded with Math.round(value * 100) / 100 before validating the stored range 0.1 through 10 inclusive.
        - `ACTION` number: Rounded with Math.round(value * 100) / 100 before validating the stored range 0.1 through 10 inclusive.
        - `MILESTONE` number: Rounded with Math.round(value * 100) / 100 before validating the stored range 0.1 through 10 inclusive.
        - `GAME_WINNER` number: Rounded with Math.round(value * 100) / 100 before validating the stored range 0.1 through 10 inclusive.
    - object
      - `scope` 'platform', required
      - `rarityBases` object
        - `COMMON` integer
        - `RARE` integer
        - `EPIC` integer
        - `LEGENDARY` integer
        - `MYTHIC` integer
      - `momentFactors` object, required
        - `PORTRAIT` number: Rounded with Math.round(value * 100) / 100 before validating the stored range 0.1 through 10 inclusive.
        - `ACTION` number: Rounded with Math.round(value * 100) / 100 before validating the stored range 0.1 through 10 inclusive.
        - `MILESTONE` number: Rounded with Math.round(value * 100) / 100 before validating the stored range 0.1 through 10 inclusive.
        - `GAME_WINNER` number: Rounded with Math.round(value * 100) / 100 before validating the stored range 0.1 through 10 inclusive.
  - object
    - `scope` 'team', required
    - `teamId` string, required
    - `rarityBases` object, required
      - `COMMON` integer, nullable
      - `RARE` integer, nullable
      - `EPIC` integer, nullable
      - `LEGENDARY` integer, nullable
      - `MYTHIC` integer, nullable

## Response `200`

Card value tables after the write

- object
  - `success` true, required
  - `data` object, required: Card value tables. effectiveRarityBases = the team's override where set, else the platform default.
    - `platformRarityBases` object, required
      - `COMMON` integer, required
      - `RARE` integer, required
      - `EPIC` integer, required
      - `LEGENDARY` integer, required
      - `MYTHIC` integer, required
    - `teamId` string, nullable, required
    - `teamRarityBases` object, nullable, required: Only the team's overrides; null without teamId.
      - `COMMON` integer
      - `RARE` integer
      - `EPIC` integer
      - `LEGENDARY` integer
      - `MYTHIC` integer
    - `effectiveRarityBases` object, required
      - `COMMON` integer, required
      - `RARE` integer, required
      - `EPIC` integer, required
      - `LEGENDARY` integer, required
      - `MYTHIC` integer, required
    - `momentFactors` object, required
      - `PORTRAIT` number, required
      - `ACTION` number, required
      - `MILESTONE` number, required
      - `GAME_WINNER` number, required

## Other responses

- `400`: Validation error (VALIDATION_ERROR)
- `401`: Authentication required
- `403`: Authenticated caller is neither admin nor superadmin (FORBIDDEN); club membership is insufficient.
- `404`: Team not found (NOT_FOUND)
- `500`: Settings read or transaction failed (INTERNAL_ERROR)

## Changes

- **2026-11-18** `6de639c52609`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/admin/card-value/put.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)
