---
title: "Run Tryon Jobs"
method: POST
path: "/api/tryon/run"
tags: ["tryon"]
---

# Run Tryon Jobs

`POST /api/tryon/run`

## 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/run`
- Auth: HTTP bearer

## Request body

- TryonRunRequest
  - `project_id` string, uuid, required
  - `row_ids` string[], nullable
  - `recipe_key` string
  - `prompt` string, nullable
  - `qa_note` string, nullable
  - `resolution` string, nullable
  - `aspect_ratio` string, nullable
  - `agent_id` string, uuid, nullable
  - `free_retry_of_row_id` string, uuid, nullable

## Response `200`

Successful Response

- TryonRunResponse
  - `workspace` TryonWorkspaceResponse, required
    - `project` TryonProjectResponse, required
      - `id` string, uuid, required
      - `owner_user_id` string, uuid, required
      - `owner_team_id` string, uuid, nullable, required
      - `program_id` string, uuid, nullable
      - `name` string, required
      - `description` string, nullable, required
      - `settings` object, required
      - `row_count_cached` integer, required
      - `job_count_cached` integer, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `archived_at` string, date-time, nullable, required
    - `columns` TryonColumnSpec[], required
      - `key` string, required
      - `label` string, required
      - `type` string, required
      - `width` integer
      - `step` string, nullable
      - `required` boolean
      - `pinned` string, nullable
      - `options` string[], nullable
      - `option_meta` TryonOptionMeta[], nullable
        - `value` string, required
        - `label` string, nullable
        - `sketch_url` string, nullable
        - `product_types` string[], nullable
        - `model_categories` string[], nullable
        - `description` string, nullable
      - `description` string, nullable
      - `form_schema` TryonFormSchema
        - `fields` TryonFormFieldSpec[]
          - `key` string, required
          - `label` string, required
          - `kind` string
          - `options` string[], nullable
          - `default` string, nullable
    - `recipes` TryonRecipeResponse[], required
      - `id` string, uuid, required
      - `project_id` string, uuid, required
      - `owner_user_id` string, uuid, required
      - `owner_team_id` string, uuid, nullable, required
      - `recipe_key` string, required
      - `name` string, required
      - `description` string, nullable, required
      - `step_order` integer, required
      - `enabled` boolean, required
      - `trigger` string, required
      - `depends_on` unknown[], required
        - unknown
      - `input_schema` object, required
      - `output_schema` object, required
      - `dispatch` object, required
      - `ui` object, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `rows` TryonRowResponse[], required
      - `id` string, uuid, required
      - `project_id` string, uuid, required
      - `owner_user_id` string, uuid, required
      - `owner_team_id` string, uuid, nullable, required
      - `order_index` integer, required
      - `sku_id` string, nullable, required
      - `product_type` string, nullable, required
      - `garment_category` string, nullable, required
      - `status` string, required
      - `data` object, required
      - `step_state` object, required
      - `billing_charged` boolean, nullable
      - `billing_refunded` boolean
      - `free_retry_used` boolean
      - `archived_at` string, date-time, nullable, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `cell_states` TryonCellStateResponse[]
      - `id` string, uuid, required
      - `project_id` string, uuid, required
      - `row_id` string, uuid, required
      - `cell_key` string, required
      - `state` string, required
      - `current_job_id` string, uuid, nullable, required
      - `current_version_id` string, uuid, nullable, required
      - `error_message` string, nullable, required
      - `blocker` object, nullable, required
      - `metadata` object
      - `auto_regen_count` integer, required
      - `stale` boolean, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `resources` TryonResourceResponse[], required
      - `id` string, uuid, required
      - `project_id` string, uuid, required
      - `owner_user_id` string, uuid, required
      - `owner_team_id` string, uuid, nullable, required
      - `kind` string, required
      - `role` string, nullable, required
      - `label` string, nullable, required
      - `s3_key` string, nullable, required
      - `external_url` string, nullable, required
      - `metadata` object
      - `archived_at` string, date-time, nullable, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `jobs` TryonJobResponse[], required
      - `id` string, uuid, required
      - `project_id` string, uuid, required
      - `row_id` string, uuid, nullable, required
      - `owner_user_id` string, uuid, required
      - `owner_team_id` string, uuid, nullable, required
      - `sku_id` string, nullable, required
      - `product_type` string, nullable, required
      - `step_key` string, nullable, required
      - `recipe_key` string, nullable, required
      - `status` string, required
      - `atom_type` string, nullable, required
      - `atom_job_id` string, nullable, required
      - `source_kind` string, nullable, required
      - `source_ref` string, nullable, required
      - `input_payload` object, required
      - `output_payload` object, required
      - `error_message` string, nullable, required
      - `attempt_count` integer, required
      - `started_at` string, date-time, nullable, required
      - `completed_at` string, date-time, nullable, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `logs` TryonExecutionLogResponse[], required
      - `id` string, uuid, required
      - `project_id` string, uuid, required
      - `row_id` string, uuid, nullable, required
      - `job_id` string, uuid, nullable, required
      - `actor_kind` string, required
      - `actor_id` string, nullable, required
      - `event_kind` string, required
      - `cell_key` string, nullable, required
      - `message` string, nullable, required
      - `payload` object, required
      - `created_at` string, date-time, required
  - `jobs` TryonJobResponse[], required
    - `id` string, uuid, required
    - `project_id` string, uuid, required
    - `row_id` string, uuid, nullable, required
    - `owner_user_id` string, uuid, required
    - `owner_team_id` string, uuid, nullable, required
    - `sku_id` string, nullable, required
    - `product_type` string, nullable, required
    - `step_key` string, nullable, required
    - `recipe_key` string, nullable, required
    - `status` string, required
    - `atom_type` string, nullable, required
    - `atom_job_id` string, nullable, required
    - `source_kind` string, nullable, required
    - `source_ref` string, nullable, required
    - `input_payload` object, required
    - `output_payload` object, required
    - `error_message` string, nullable, required
    - `attempt_count` integer, required
    - `started_at` string, date-time, nullable, required
    - `completed_at` string, date-time, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `skipped_rows` object[]
  - `message` string, required

## 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)