---
title: "Confirm a signed pack / collectible asset upload"
method: POST
path: "/api/admin/packs/confirm-upload"
tags: ["Admin", "Packs"]
---

# Confirm a signed pack / collectible asset upload

`POST /api/admin/packs/confirm-upload`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/admin/packs/confirm-upload`
- Auth: HTTP bearer

Team managers only, except a global template at templates/ which requires an admin. Revalidates the stored object: path prefix, size equals expectedSize, and magic. kind glb-template downloads the object (max 10MB), rejects text/html, Draco, and KTX2, accepts EXT_meshopt_compression, and returns glbTemplateVersion, glbIdleClip, glbMinScene (3 for meshopt, else null) and material slots. Version 0 is pack FRONT/BACK and requires KHR_texture_transform on both (UV window on a 1024x1536 canvas). Version 1 is the card case (TeamArt/CardBack). Version 2 is the combined opening (FRONT, BACK, TeamArt, CardBack) with a full-bleed 1104x1536 pack-face canvas and no texture transform. Declaring version 0 for a file that satisfies version 2 is rejected. Pack art kinds contain into the version-0 window or the version-2 1104x1536 canvas. Card-case art kinds cover a 1200x1680 canvas. glbTemplateVersion is never defaulted. glbIdleClip is null unless it is CaseIdle on version 2.

## Request body

- object
  - `teamId` string
  - `path` string, required
  - `kind` 'model' | 'video' | 'artwork' | 'collectible-model' | 'collectible-video' | 'glb-template' | 'pack-art-front' | 'pack-art-back' | 'card-case-art' | 'card-back', required
  - `expectedSize` integer, required
  - `publicUrl` string: Echoed back when valid.
  - `glbTemplateVersion` integer: kind glb-template: omitted detects the contract. Never defaulted. 0 is pack FRONT/BACK with KHR_texture_transform. 2 is the combined opening and cannot be declared as 0. Pack art kinds: 0 selects the 1024x1536 UV window; 2 selects the full-bleed 1104x1536 canvas.
  - `glbIdleClip` string, nullable: kind glb-template only. Null or omitted means idle is off. The only other value is CaseIdle, and only when glbTemplateVersion is 2.

## Response `200`

{ path, kind, size, publicUrl, bucket, confirmed, glbTemplateVersion?, glbIdleClip?, glbMinScene?, templateKind?, slots? }

- object
  - `success` true, required
  - `data` object, required
    - `path` string, required
    - `kind` string, required
    - `size` integer, required
    - `publicUrl` string, required
    - `bucket` string, required
    - `confirmed` true, required
    - `glbTemplateVersion` integer: Present for kind glb-template. 0 is FRONT/BACK with KHR_texture_transform (1024x1536 UV window). 2 is the combined opening (full-bleed 1104x1536 pack faces).
    - `glbIdleClip` string, nullable: Present for kind glb-template. Null means idle is off. CaseIdle is valid only when glbTemplateVersion is 2.
    - `glbMinScene` integer, nullable: Present for kind glb-template. 3 means EXT_meshopt_compression; null means no scene-level requirement.
    - `templateKind` 'pack' | 'card-case'
    - `slots` object[]
      - `role` string, required
      - `material` string, required

## Other responses

- `400`: VALIDATION_ERROR — path outside the team prefix, size mismatch / over cap, bad magic, unexpected content-type, or unknown glbTemplateVersion
- `401`: Authentication required
- `403`: FORBIDDEN — caller cannot manage the team
- `404`: NOT_FOUND — uploaded object not in storage

## Changes

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

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