---
title: "Mint a signed upload URL for pack or card-case art"
method: POST
path: "/api/admin/packs/upload-pack-art"
tags: ["Admin", "Packs"]
---

# Mint a signed upload URL for pack or card-case art

`POST /api/admin/packs/upload-pack-art`

## Request

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

Team managers only (canManageTeam). Staging key teams/{teamId}/pack-art/{front|back|card-case|card-back}/staging/. Confirm with the same kind. Pack front/back require glbTemplateVersion 0 or 2: version 0 contains the image in the UV window on a 1024x1536 canvas, and version 2 fills a 1104x1536 canvas. Card-case and card-back ignore glbTemplateVersion; confirm covers a 1200x1680 canvas. The stored object is immutable.

## Request body

- object
  - `teamId` string, required
  - `kind` 'pack-art-front' | 'pack-art-back' | 'card-case-art' | 'card-back', required
  - `fileName` string, required
  - `fileSize` integer, required
  - `mimeType` 'image/png' | 'image/jpeg' | 'image/webp', required
  - `magicBytes` string, byte, required
  - `glbTemplateVersion` 0 | 2: Required for pack-art-front and pack-art-back. 0 selects the UV window on a 1024x1536 canvas. 2 selects the full-bleed 1104x1536 canvas. Omitted or any other integer is rejected for those kinds. card-case-art and card-back ignore this property.

## Response `200`

{ signedUrl, token, path, publicUrl, bucket, contentType }

## Other responses

- `400`: VALIDATION_ERROR
- `401`: Authentication required
- `403`: FORBIDDEN

## 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/upload-pack-art/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)
