---
title: "Get Workspace"
method: GET
path: "/api/tryon/projects/{project_id}/workspace"
tags: ["tryon"]
---

# Get Workspace

`GET /api/tryon/projects/{project_id}/workspace`

## 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/projects/{project_id}/workspace`
- Auth: HTTP bearer

## Path parameters

- `project_id` string, uuid, required

## Query parameters

- `limit` integer

## Response `200`

Successful Response

- TryonWorkspaceResponse
  - `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

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