tryon

Free Generate Cell

Free-form generate for cells without a static recipe.

Driver: user feedback 2026-05-20 — clicking "Generate" on a cell like scene (no recipe defined) used to either 400 with "unsupported tryon recipe" or fall back to chat-the-agent, which then refused. This endpoint accepts a natural-language prompt + optional reference S3 keys and dispatches the smart_edit atom with _target_cell_key stamped so the deliver handler writes the result back to the chosen cell — no recipe registration required.

post/api/tryon/rows/{row_id}/cells/{cell_key}/free-generate

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}/cells/{cell_key}/free-generate
  • Auth: HTTP bearer

Path parameters

row_idstring uuid required
cell_keystring required

Request body

promptstring required
reference_keysstring[]
agent_idstring uuid nullable
resolutionstring nullable
aspect_ratiostring nullable

Response

Successful Response

idstring uuid required
project_idstring uuid required
row_idstring uuid nullable required
owner_user_idstring uuid required
owner_team_idstring uuid nullable required
sku_idstring nullable required
product_typestring nullable required
step_keystring nullable required
recipe_keystring nullable required
statusstring required
atom_typestring nullable required
atom_job_idstring nullable required
source_kindstring nullable required
source_refstring nullable required
input_payloadobject required
output_payloadobject required
error_messagestring nullable required
attempt_countinteger required
started_atstring date-time nullable required
completed_atstring date-time nullable required
created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.