---
title: "Ingest Tryon Resources"
method: POST
path: "/api/tryon/ingest"
tags: ["tryon"]
---

# Ingest Tryon Resources

`POST /api/tryon/ingest`

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

## Request body

- TryonIngestRequest
  - `project_id` string, uuid, required
  - `resource_ids` string[], required
  - `prompt` string, nullable
  - `agent_id` string, uuid, nullable
  - `mode` 'auto' | 'garments' | 'models'

## Response `200`

Successful Response

- TryonIngestResponse
  - `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
  - `created_rows` integer, required
  - `created_resources` integer, required
  - `assigned_resources` integer, required
  - `needs_review` integer, required
  - `message` string, required
  - `parse_report` object

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