---
title: "Generate Row Listing Copy"
method: POST
path: "/api/tryon/rows/{row_id}/listing-copy"
tags: ["tryon"]
---

# Generate Row Listing Copy

`POST /api/tryon/rows/{row_id}/listing-copy`

## Request

- Base URL: `https://api.tintin-x.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tintin-x.com/api/tryon/rows/{row_id}/listing-copy`
- Auth: HTTP bearer

Listing Pack v2: publish-ready copy for ONE platform, generated from
the row's FINAL try-on image (one GPT vision call, free — "随图出").

The FE contract (tintin-web ``lib/tryon/listing-client.ts``): the pack
envelope keys copy by platform; v2 generates the REQUESTED platform
(default: the user's connected Radar shop's platform, else shopify) and
the FE re-requests per platform tab. Shop Radar context (brand, store
tag vocabulary, a reference listing) is folded into the task prompt when
the user has an active shop — ``shop_context`` in the response says so.

Prompts are registry-managed (``tryon.listing_copy`` system +
``tryon.listing_copy.task`` template); published versions take effect
here immediately, no deploy. 404/405/501 keep meaning "coming soon" to
the FE — the dark-launch flag below returns 501 until rollout.

## Path parameters

- `row_id` string, uuid, required

## Request body

- ListingCopyRequest: The Listing Pack request — everything beyond ``language`` is the FE settings panel, all optional; explicit values beat Radar-derived ones.
  - `language` string
  - `platform` string, nullable
  - `brand_name` string, nullable
  - `product_category` string, nullable
  - `known_facts` string[]
  - `target_market` string, nullable
  - `price_tier` string, nullable
  - `brand_voice` string, nullable
  - `primary_keyword` string, nullable
  - `secondary_keywords` string[]
  - `banned_words` string[]
  - `title_case` boolean
  - `use_shop_context` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tintin-x/apis/tintin-api.md) · [All operations](https://skmtc.dev/tintin-x/apis/tintin-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tintin-x/apis/tintin-api/revisions/8839a8d0a66c?raw)