# 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 (this domain — proxied to MockupDesk)

Base URL: `https://mockups.md`

Register: `POST /api/v1/agent/register` (returns `asg_agent_*` key once; store securely)

| Method | Path | Purpose |
|--------|------|---------|
| POST | `/api/v1/agent/register` | Register agent; receive API key |
| POST | `/api/mockup/create` | Create mockup from artwork (agent key required when auth enabled) |
| 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: **Authorization: Bearer asg_agent_*** for mockup create (when `AGENT_CREATE_AUTH_REQUIRED=true`). Internal callers may use `X-PressOS-Key`. Read endpoints are UUID-capability with IP rate limits.

OpenAPI: 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 — quote at [custom-tshirts.md](https://custom-tshirts.md/) using `POST /api/v1/agent/pricing/quote-from-mockup`.

## Related discovery

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