---
title: "Rename binder, update cover, or set built cover style"
method: PATCH
path: "/api/binders/{id}"
tags: ["Binders", "Collectibles and packs"]
---

# Rename binder, update cover, or set built cover style

`PATCH /api/binders/{id}`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/binders/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- object
  - `name` string
  - `coverImage` string, nullable
  - `coverStyle` object, nullable: Built cover design (v1: material, colour, foil, hardware, strap, label, nameStamp, emblem, art). Null clears to the classic cover. Unknown keys are dropped. Photo emblem uri must be an https binder-cover blob the caller owns or an owned collectible image. Team emblem sends { kind: team, teamId }; teamId must exist and have an https logo (its own, else its league's), and the stored and returned source carries the team's name and that logo as uri (any name/uri sent is ignored). art is null, an owned https image URL, or a cover token: mock-cover:<id> or a catalog id (letters, digits, _ . -; at most 160 characters).
    - `v` 1, required
    - `material` 'leather' | 'pebble' | 'linen' | 'carbon' | 'metal' | 'printed', required
    - `colour` 'navy' | 'royal' | 'oxblood' | 'forest' | 'sand' | 'ivory' | 'black' | 'graphite', required
    - `foil` 'gold' | 'silver' | 'rose' | 'holo' | 'deboss', required
    - `hardware` 'gold' | 'chrome' | 'gunmetal' | 'none', required
    - `strap` boolean, required
    - `label` boolean, required
    - `nameStamp` 'front' | 'spine' | 'both' | 'none', required
    - `emblem` object, nullable, required
      - `shape` 'circle' | 'square' | 'rect', required
      - `source` union, required
        - object
          - `kind` 'team', required
          - `teamId` string, required
          - `name` string: Response only: the team's name (ignored on input).
          - `uri` string: Response only: the team's logo, else its league's (ignored on input).
        - object
          - `kind` 'photo', required
          - `uri` string, required
    - `art` string, nullable: Printed art: an owned https image URL, or a cover token (mock-cover:<id> or a catalog id).

## Response `200`

{ binder }

## Other responses

- `400`: VALIDATION_ERROR

## Changes

- **2026-11-18** `6de639c52609`: 1 info
  - added the new optional request property `coverStyle`
- **2026-08-16** `16bfbac187d7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/binders/:id/patch.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)
