# Mockups — Apparel Supply Group (Artifact)

> Certified production mockup generation. The choke point where intent becomes a deterministic production contract: garment, placement, Pantones, preview image.

This endpoint is for **specification**: turn artwork into a mockup that locks what will be printed. Mockups supply ink colors (Pantones), print locations, and garment color for pricing and production.

Brand site: https://apparelsupplygroup.com  
Brand governed facts: https://www.apparelsupplygroup.com/llms.txt  
Contact: support@apparelsupplygroup.com | 562.661.9611 (M-F 9am-6pm PST)

## Why mockups matter

A certified mockup is the production contract. What you approve is what gets printed. Pricing uses the mockup's color count and locations; production routes from the mockup ID.

## Agent capability flow

```
custom-tshirts.md → mockups.md (you are here) → tshirt-printing.md
     intent / quote        artifact                 execution
```

- Previous: [custom-tshirts.md](https://custom-tshirts.md/) — instant quote and catalog
- Next: [tshirt-printing.md](https://tshirt-printing.md/) — production routing (human approval)

## Machine access

Discovery manifest: https://mockups.md/.well-known/agents.json

### API base (MockupDesk)

Base URL: `https://mockupdesk.apparelsupplygroup.com`

| Method | Path | Purpose |
|--------|------|---------|
| POST | `/api/mockup/create` | Create mockup from artwork (file upload or URL) |
| POST | `/api/mockup/create-batch` | Multi-placement batch create |
| GET | `/api/v1/mockup/<id>` | Full mockup payload |
| GET | `/api/v1/mockup/<id>/image` | Mockup preview image |
| GET | `/api/v1/mockup/<id>/pantones` | Extracted Pantone colors |
| GET | `/api/v1/mockup/<id>/placement` | Placement dimensions |
| GET | `/api/garments` | Garment catalog |

Auth (Phase 2+): **agent API key required** for mockup creation. Read endpoints may remain open with rate limits.

Phase 0: documentation and discovery only; keyed registration at `POST /api/v1/agent/register` (coming).

OpenAPI (curated, coming Phase 1): https://mockups.md/openapi.json

## Inputs

- Artwork (PNG, JPG, PDF, or URL)
- Garment type / style / color
- Print placement(s)

Outputs: mockup ID, preview URL, Pantone list, placement metadata — link to quote at custom-tshirts.md using derived color counts.

## Related discovery

- [custom-tshirts.md](https://custom-tshirts.md/)
- [tshirt-printing.md](https://tshirt-printing.md/)