Uwear

Official77 tools

by uwear

AI photoshoot studio: garments, avatars, locations, and art direction

ai.uwear/uwear — Model Context Protocol (MCP) Server

The ai.uwear/uwear MCP server provides access to an AI photoshoot studio workflow focused on garments, avatars, locations, and art direction. It exposes 77 tools through the Model Context Protocol to support building and organizing these studio components.

🛠️ Key Features

AI photoshoot studio capabilities
Garments
Avatars
Locations
Art direction
77 available tools

🚀 Use Cases

Creating AI-driven photoshoot scenes using garments
Generating or refining avatar contexts for shoots
Associating shoots with specific locations
Supporting art direction for scene composition

⚡ Developer Benefits

MCP tool integration for studio-related tasks
Tool-based access pattern (77 tools)

⚠️ Limitations

Limited metadata provided (no topics or readme excerpt available)

Captured live from the server via tools/list.

search_uwear_library

Universal hybrid retrieval across the user's visible Uwear library: garments, avatars/models, locations, ArtDirections, uploaded files, and generation results. Use this before opening the picker when the user describes assets or saved creative direction by exact name/SKU or natural language, e.g. 'SKU 42', 'urban art direction', 'summer denim', or 'studio model'. For saved outfits, retrieve matching garments first, then call list_outfits with clothing_item_ids or propose_outfits from the garment IDs. Returns stable typed IDs, ids_by_type, detail_tool/detail_arguments, and selection hints; for saved ArtDirections, use the returned art_direction_id in briefs. This combines indexed lexical matching with vector retrieval; do not run separate substring searches.

Parameters4

query	string	required	Hybrid retrieval query. Handles exact names/SKUs/IDs and natural-language visual or attribute intent.
item_types	array	optional	Optional item types to search. Omit to search clothing, avatars/models, locations, art directions, uploaded files, and generation results.
limit	integer	optional	Maximum number of hybrid matches to return
refresh_index	boolean	optional	Force-refresh missing or stale index rows for currently visible library items before searching. Leave false for normal MCP use; search refreshes once automatically only when no accessible match is found.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Hybrid retrieval query. Handles exact names/SKUs/IDs and natural-language visual or attribute intent.",
      "minLength": 2,
      "type": "string"
    },
    "item_types": {
      "default": null,
      "description": "Optional item types to search. Omit to search clothing, avatars/models, locations, art directions, uploaded files, and generation results.",
      "items": {
        "enum": [
          "clothing_item",
          "avatar",
          "location",
          "art_direction",
          "uploaded_file",
          "generation_result"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "limit": {
      "default": 10,
      "description": "Maximum number of hybrid matches to return",
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "refresh_index": {
      "default": false,
      "description": "Force-refresh missing or stale index rows for currently visible library items before searching. Leave false for normal MCP use; search refreshes once automatically only when no accessible match is found.",
      "type": "boolean"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "description": "Input schema for universal hybrid library search."
}

list_garments

List user's garments with structured filters or query for hybrid name/SKU/metadata/image-attribute search.

Parameters9

query	string	optional	Hybrid search across garment names, SKUs, metadata, and visual attributes.
clothing_item_ids	array	optional	Filter to specific garment IDs
tag_ids	array	optional	Filter to garments with any of these tags
start_date	string	optional	Filter: created on or after this date (ISO format, e.g. '2025-06-01')
end_date	string	optional	Filter: created on or before this date (ISO format)
sort	string	optional	Sort order: 'field:direction', e.g. 'created_at:desc', 'clothing_item_name:asc'. Default: created_at:desc
page	integer	optional	Page number for pagination
limit	integer	optional	Number of items per page
include_image_url	boolean	optional	Set true when the garment image itself is needed for visual display or reuse.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "default": null,
      "description": "Hybrid search across garment names, SKUs, metadata, and visual attributes.",
      "minLength": 2,
      "type": "string"
    },
    "clothing_item_ids": {
      "default": null,
      "description": "Filter to specific garment IDs",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "tag_ids": {
      "default": null,
      "description": "Filter to garments with any of these tags",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "start_date": {
      "default": null,
      "description": "Filter: created on or after this date (ISO format, e.g. '2025-06-01')",
      "type": "string"
    },
    "end_date": {
      "default": null,
      "description": "Filter: created on or before this date (ISO format)",
      "type": "string"
    },
    "sort": {
      "default": null,
      "description": "Sort order: 'field:direction', e.g. 'created_at:desc', 'clothing_item_name:asc'. Default: created_at:desc",
      "type": "string"
    },
    "page": {
      "default": 1,
      "description": "Page number for pagination",
      "minimum": 1,
      "type": "integer"
    },
    "limit": {
      "default": 10,
      "description": "Number of items per page",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "include_image_url": {
      "default": false,
      "description": "Set true when the garment image itself is needed for visual display or reuse.",
      "type": "boolean"
    }
  },
  "additionalProperties": false,
  "description": "Input schema for listing garments."
}

get_garment

Get a specific garment by ID.

Parameters1

garment_id

integer

required

The garment ID to retrieve

Raw schema

{
  "type": "object",
  "properties": {
    "garment_id": {
      "description": "The garment ID to retrieve",
      "type": "integer"
    }
  },
  "required": [
    "garment_id"
  ],
  "description": "Input schema for getting a specific garment."
}

upload_garment_from_chat_file

Batch upload garments from ChatGPT attachments. Defaults to background removal; pass processing_mode='none' to store original images as-is. Pass actual file objects only in top-level image_file_1, image_file_2, etc. Prefer garments[].assets with {asset_kind: full|detail, asset_view: front|back|side, image_file: 'image_file_N'}; exactly one full front is required, every full view is unique, and detail views can repeat. Do not rely on array position to pair assets; every asset must reference its exact top-level field name. No image_url here; use upload_garment_from_public_url for URLs. For local filesystem files, use prepare_local_garment_upload instead. No base64 and no local paths.

Parameters21

garments	array	required	Garment metadata. Put files in top-level image_file_1..image_file_20 and reference those exact field names inside each garment. No base64.
image_file_1	any	optional	Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order.
image_file_2	any	optional	Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order.
image_file_3	any	optional	Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order.
image_file_4	any	optional	Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order.
image_file_5	any	optional	Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order.
image_file_6	any	optional	Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order.
image_file_7	any	optional	Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order.
image_file_8	any	optional	Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order.
image_file_9	any	optional	Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order.
image_file_10	any	optional	Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order.
image_file_11	any	optional	Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order.
image_file_12	any	optional	Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order.
image_file_13	any	optional	Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order.
image_file_14	any	optional	Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order.
image_file_15	any	optional	Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order.
image_file_16	any	optional	Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order.
image_file_17	any	optional	Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order.
image_file_18	any	optional	Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order.
image_file_19	any	optional	Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order.
image_file_20	any	optional	Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order.

Raw schema

{
  "type": "object",
  "properties": {
    "garments": {
      "description": "Garment metadata. Put files in top-level image_file_1..image_file_20 and reference those exact field names inside each garment. No base64.",
      "items": {
        "$ref": "#/$defs/GarmentChatFileUploadItem"
      },
      "maxItems": 10,
      "minItems": 1,
      "type": "array"
    },
    "image_file_1": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order."
    },
    "image_file_2": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order."
    },
    "image_file_3": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order."
    },
    "image_file_4": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order."
    },
    "image_file_5": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order."
    },
    "image_file_6": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order."
    },
    "image_file_7": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order."
    },
    "image_file_8": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order."
    },
    "image_file_9": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order."
    },
    "image_file_10": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order."
    },
    "image_file_11": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order."
    },
    "image_file_12": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order."
    },
    "image_file_13": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order."
    },
    "image_file_14": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order."
    },
    "image_file_15": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order."
    },
    "image_file_16": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order."
    },
    "image_file_17": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order."
    },
    "image_file_18": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order."
    },
    "image_file_19": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order."
    },
    "image_file_20": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Top-level ChatGPT file attachment. In garments[], reference this exact field name from assets[].image_file, e.g. image_file='image_file_1'. Do not rely on item order."
    }
  },
  "required": [
    "garments"
  ],
  "$defs": {
    "GarmentChatFileAssetInput": {
      "description": "One classified garment asset for chat-file upload.",
      "properties": {
        "asset_kind": {
          "default": null,
          "description": "Asset kind: full garment view or detail crop.",
          "enum": [
            "full",
            "detail"
          ],
          "type": "string"
        },
        "asset_view": {
          "default": null,
          "description": "Visible garment view. New detail uploads require front, back, or side.",
          "enum": [
            "front",
            "back",
            "side",
            "unspecified"
          ],
          "type": "string"
        },
        "asset_role": {
          "default": null,
          "deprecated": true,
          "description": "Deprecated role-only adapter. Prefer asset_kind and asset_view.",
          "enum": [
            "front",
            "back",
            "side",
            "detail"
          ],
          "type": "string"
        },
        "image_file": {
          "description": "Name of the top-level ChatGPT file param for this asset, e.g. image_file_1.",
          "type": "string"
        },
        "file_name": {
          "default": null,
          "description": "Original file name for this asset",
          "type": "string"
        },
        "mime_type": {
          "default": null,
          "description": "MIME/content type for this asset, e.g. image/png",
          "type": "string"
        }
      },
      "required": [
        "image_file"
      ],
      "type": "object"
    },
    "GarmentChatFileUploadItem": {
      "description": "One garment upload item for chat-file batch upload.",
      "properties": {
        "name": {
          "default": null,
          "description": "Name for the garment. If omitted, derived from the image filename.",
          "type": "string"
        },
        "description": {
          "default": null,
          "description": "Optional item-level garment description hint",
          "type": "string"
        },
        "gender": {
          "default": null,
          "description": "Target gender: male, female, unisex",
          "type": "string"
        },
        "file_name": {
          "default": null,
          "description": "Original file name",
          "type": "string"
        },
        "mime_type": {
          "default": null,
          "description": "MIME/content type, e.g. image/png",
          "type": "string"
        },
        "processing_mode": {
          "default": null,
          "description": "Optional image processing. 'background_removal' removes the background (the platform upload default); 'none' stores the image as-is. Omit to use background removal.",
          "type": "string"
        },
        "image_file": {
          "default": null,
          "description": "Legacy shortcut: top-level ChatGPT file param for the front image, e.g. image_file_1.",
          "type": "string"
        },
        "back_image_file": {
          "default": null,
          "description": "Legacy shortcut: optional top-level ChatGPT file param for the back image.",
          "type": "string"
        },
        "side_image_file": {
          "default": null,
          "description": "Legacy shortcut: optional top-level ChatGPT file param for the side image.",
          "type": "string"
        },
        "detail_image_files": {
          "default": null,
          "description": "Legacy shortcut: optional top-level ChatGPT file params for detail images.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "assets": {
          "default": null,
          "description": "Full garment asset set. Each asset references a top-level image_file_N field and declares asset_kind/asset_view. Exactly one full front is required; full front/back/side are unique and detail views can repeat.",
          "items": {
            "$ref": "#/$defs/GarmentChatFileAssetInput"
          },
          "type": "array"
        }
      },
      "type": "object"
    },
    "MCPFileReference": {
      "additionalProperties": true,
      "description": "Host-provided MCP file reference for user-uploaded images.",
      "properties": {
        "download_url": {
          "default": null,
          "description": "Temporary host-authorized download URL for this file",
          "type": "string"
        },
        "url": {
          "default": null,
          "description": "Temporary/public file URL when the host exposes one",
          "type": "string"
        },
        "uri": {
          "default": null,
          "description": "Host file URI when available",
          "type": "string"
        },
        "file_id": {
          "default": null,
          "description": "Host file ID",
          "type": "string"
        },
        "mime_type": {
          "default": null,
          "description": "File MIME type, e.g. image/png",
          "type": "string"
        },
        "content_type": {
          "default": null,
          "description": "File content type, e.g. image/png",
          "type": "string"
        },
        "file_name": {
          "default": null,
          "description": "Original uploaded file name",
          "type": "string"
        },
        "name": {
          "default": null,
          "description": "Original uploaded file name when the host uses name",
          "type": "string"
        }
      },
      "type": "object"
    }
  },
  "description": "Input schema for uploading garments from chat file references."
}

upload_garment_from_public_url

Batch upload garments from public HTTP(S) image URLs. Defaults to background removal; pass processing_mode='none' to store original images as-is. Prefer assets with {asset_kind: full|detail, asset_view: front|back|side, asset_url}; exactly one full front is required, every full view is unique, and detail views can repeat. For ChatGPT attachments, use upload_garment_from_chat_file instead. For local filesystem files, use prepare_local_garment_upload instead. No base64, chat file objects, or local paths.

Parameters12

garments	array	optional	Garments to upload from public HTTP(S) URLs. No chat file objects and no base64.
image_url	string	optional	Single public HTTP(S) front image URL
back_image_url	string	optional	Single optional public HTTP(S) back image URL
side_image_url	string	optional	Single optional public HTTP(S) side image URL
detail_image_urls	array	optional	Single optional public HTTP(S) detail image URLs
assets	array	optional	Single garment full asset set. Use asset_kind/asset_view. Exactly one full front is required; full views are unique and detail views can repeat.
name	string	optional	Single garment name
description	string	optional	Single item-level garment description hint
gender	string	optional	Single garment gender: male, female, unisex
file_name	string	optional	Single original file name
mime_type	string	optional	Single MIME/content type, e.g. image/png
processing_mode	string	optional	Optional image processing. 'background_removal' removes the background (the platform upload default); 'none' stores the image as-is. Omit to use background removal.

Raw schema

{
  "type": "object",
  "properties": {
    "garments": {
      "default": null,
      "description": "Garments to upload from public HTTP(S) URLs. No chat file objects and no base64.",
      "items": {
        "$ref": "#/$defs/GarmentPublicUrlUploadItem"
      },
      "maxItems": 50,
      "type": "array"
    },
    "image_url": {
      "default": null,
      "description": "Single public HTTP(S) front image URL",
      "type": "string"
    },
    "back_image_url": {
      "default": null,
      "description": "Single optional public HTTP(S) back image URL",
      "type": "string"
    },
    "side_image_url": {
      "default": null,
      "description": "Single optional public HTTP(S) side image URL",
      "type": "string"
    },
    "detail_image_urls": {
      "default": null,
      "description": "Single optional public HTTP(S) detail image URLs",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "assets": {
      "default": null,
      "description": "Single garment full asset set. Use asset_kind/asset_view. Exactly one full front is required; full views are unique and detail views can repeat.",
      "items": {
        "$ref": "#/$defs/GarmentPublicUrlAssetInput"
      },
      "type": "array"
    },
    "name": {
      "default": null,
      "description": "Single garment name",
      "type": "string"
    },
    "description": {
      "default": null,
      "description": "Single item-level garment description hint",
      "type": "string"
    },
    "gender": {
      "default": null,
      "description": "Single garment gender: male, female, unisex",
      "type": "string"
    },
    "file_name": {
      "default": null,
      "description": "Single original file name",
      "type": "string"
    },
    "mime_type": {
      "default": null,
      "description": "Single MIME/content type, e.g. image/png",
      "type": "string"
    },
    "processing_mode": {
      "default": null,
      "description": "Optional image processing. 'background_removal' removes the background (the platform upload default); 'none' stores the image as-is. Omit to use background removal.",
      "type": "string"
    }
  },
  "$defs": {
    "GarmentPublicUrlAssetInput": {
      "description": "One classified garment asset for public URL upload.",
      "properties": {
        "asset_kind": {
          "default": null,
          "description": "Asset kind: full garment view or detail crop.",
          "enum": [
            "full",
            "detail"
          ],
          "type": "string"
        },
        "asset_view": {
          "default": null,
          "description": "Visible garment view. New detail uploads require front, back, or side.",
          "enum": [
            "front",
            "back",
            "side",
            "unspecified"
          ],
          "type": "string"
        },
        "asset_role": {
          "default": null,
          "deprecated": true,
          "description": "Deprecated role-only adapter. Prefer asset_kind and asset_view.",
          "enum": [
            "front",
            "back",
            "side",
            "detail"
          ],
          "type": "string"
        },
        "asset_url": {
          "default": null,
          "description": "Public HTTP(S) image URL for this asset",
          "type": "string"
        },
        "image_url": {
          "default": null,
          "description": "Alias for asset_url",
          "type": "string"
        },
        "file_name": {
          "default": null,
          "description": "Original file name for this asset",
          "type": "string"
        },
        "mime_type": {
          "default": null,
          "description": "MIME/content type for this asset, e.g. image/png",
          "type": "string"
        }
      },
      "type": "object"
    },
    "GarmentPublicUrlUploadItem": {
      "description": "One garment upload item for public URL batch upload.",
      "properties": {
        "image_url": {
          "default": null,
          "description": "Legacy shortcut: public HTTP(S) front image URL",
          "type": "string"
        },
        "back_image_url": {
          "default": null,
          "description": "Legacy shortcut: optional public HTTP(S) back image URL",
          "type": "string"
        },
        "side_image_url": {
          "default": null,
          "description": "Legacy shortcut: optional public HTTP(S) side image URL",
          "type": "string"
        },
        "detail_image_urls": {
          "default": null,
          "description": "Legacy shortcut: optional public HTTP(S) detail image URLs",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "assets": {
          "default": null,
          "description": "Full garment asset set using asset_kind/asset_view. Exactly one full front is required; full views are unique and detail views can repeat.",
          "items": {
            "$ref": "#/$defs/GarmentPublicUrlAssetInput"
          },
          "type": "array"
        },
        "name": {
          "default": null,
          "description": "Name for the garment. If omitted, derived from the image filename.",
          "type": "string"
        },
        "description": {
          "default": null,
          "description": "Optional item-level garment description hint",
          "type": "string"
        },
        "gender": {
          "default": null,
          "description": "Target gender: male, female, unisex",
          "type": "string"
        },
        "file_name": {
          "default": null,
          "description": "Original file name",
          "type": "string"
        },
        "mime_type": {
          "default": null,
          "description": "MIME/content type, e.g. image/png",
          "type": "string"
        },
        "processing_mode": {
          "default": null,
          "description": "Optional image processing. 'background_removal' removes the background (the platform upload default); 'none' stores the image as-is. Omit to use background removal.",
          "type": "string"
        }
      },
      "type": "object"
    }
  },
  "description": "Input schema for uploading garments from public URLs."
}

list_avatars

List the user's avatars: the reusable people who wear the garments, called 'models' or 'mannequins' in fashion terms (not the AI engines — for those, use list_models). Supports structured filters or query for hybrid name/metadata/image-attribute search. Set include_image_url=true when the avatar image itself is needed.

Parameters9

query	string	optional	Hybrid search across avatar/model names, metadata, and visual attributes.
avatar_ids	array	optional	Filter to specific avatar IDs
tag_ids	array	optional	Filter to avatars with any of these tags
start_date	string	optional	Filter: created on or after this date (ISO format)
end_date	string	optional	Filter: created on or before this date (ISO format)
sort	string	optional	Sort order: 'field:direction', e.g. 'created_at:desc'. Default: created_at:desc
page	integer	optional	Page number for pagination
limit	integer	optional	Number of items per page
include_image_url	boolean	optional	Set true when you need to inspect or reuse the avatar/model image URL.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "default": null,
      "description": "Hybrid search across avatar/model names, metadata, and visual attributes.",
      "minLength": 2,
      "type": "string"
    },
    "avatar_ids": {
      "default": null,
      "description": "Filter to specific avatar IDs",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "tag_ids": {
      "default": null,
      "description": "Filter to avatars with any of these tags",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "start_date": {
      "default": null,
      "description": "Filter: created on or after this date (ISO format)",
      "type": "string"
    },
    "end_date": {
      "default": null,
      "description": "Filter: created on or before this date (ISO format)",
      "type": "string"
    },
    "sort": {
      "default": null,
      "description": "Sort order: 'field:direction', e.g. 'created_at:desc'. Default: created_at:desc",
      "type": "string"
    },
    "page": {
      "default": 1,
      "description": "Page number for pagination",
      "minimum": 1,
      "type": "integer"
    },
    "limit": {
      "default": 10,
      "description": "Number of items per page",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "include_image_url": {
      "default": false,
      "description": "Set true when you need to inspect or reuse the avatar/model image URL.",
      "type": "boolean"
    }
  },
  "additionalProperties": false,
  "description": "Input schema for listing avatars."
}

upload_avatar_from_chat_file

Batch upload reusable avatars/models from person photos the user attached in chat. Keep avatar metadata in avatars[] and pass top-level image_file_1, image_file_2, etc. in the same order. No base64, no local paths. Do not use ordinary text-to-image results or generated multi-panel sheets as an upload fallback; use generate_avatar followed by save_generated_avatar for Uwear-created avatars. Use only when the user explicitly wants a specific or consistent person.

Parameters16

avatars	array	optional	Avatar/model metadata in the same order as image_file_1, image_file_2, etc. No base64.
image_file_1	any	optional	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_2	any	optional	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_3	any	optional	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_4	any	optional	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_5	any	optional	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_6	any	optional	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_7	any	optional	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_8	any	optional	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_9	any	optional	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_10	any	optional	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_url	string	optional	Single resolved download URL used by automatic opaque-file recovery.
name	string	optional	Single recovered avatar/model name
description	object	optional	Single recovered avatar metadata
file_name	string	optional	Single recovered original file name
mime_type	string	optional	Single recovered MIME/content type, e.g. image/png

Raw schema

{
  "type": "object",
  "properties": {
    "avatars": {
      "default": null,
      "description": "Avatar/model metadata in the same order as image_file_1, image_file_2, etc. No base64.",
      "items": {
        "$ref": "#/$defs/AvatarChatFileUploadItem"
      },
      "maxItems": 10,
      "type": "array"
    },
    "image_file_1": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID."
    },
    "image_file_2": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID."
    },
    "image_file_3": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID."
    },
    "image_file_4": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID."
    },
    "image_file_5": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID."
    },
    "image_file_6": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID."
    },
    "image_file_7": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID."
    },
    "image_file_8": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID."
    },
    "image_file_9": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID."
    },
    "image_file_10": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID."
    },
    "image_url": {
      "default": null,
      "description": "Single resolved download URL used by automatic opaque-file recovery.",
      "type": "string"
    },
    "name": {
      "default": null,
      "description": "Single recovered avatar/model name",
      "type": "string"
    },
    "description": {
      "default": null,
      "description": "Single recovered avatar metadata",
      "additionalProperties": true,
      "type": "object"
    },
    "file_name": {
      "default": null,
      "description": "Single recovered original file name",
      "type": "string"
    },
    "mime_type": {
      "default": null,
      "description": "Single recovered MIME/content type, e.g. image/png",
      "type": "string"
    }
  },
  "$defs": {
    "AvatarChatFileUploadItem": {
      "description": "One avatar/model upload item for chat-file batch upload.",
      "properties": {
        "name": {
          "description": "Name for the avatar/model",
          "type": "string"
        },
        "description": {
          "default": null,
          "description": "Avatar metadata: {gender, age, body, ethnicity, hair_color, etc.}",
          "additionalProperties": true,
          "type": "object"
        },
        "file_name": {
          "default": null,
          "description": "Original file name",
          "type": "string"
        },
        "mime_type": {
          "default": null,
          "description": "MIME/content type, e.g. image/png",
          "type": "string"
        },
        "image_url": {
          "default": null,
          "description": "Resolved download URL. Used by the Uwear app when recovering a chat file ID.",
          "type": "string"
        }
      },
      "required": [
        "name"
      ],
      "type": "object"
    },
    "MCPFileReference": {
      "additionalProperties": true,
      "description": "Host-provided MCP file reference for user-uploaded images.",
      "properties": {
        "download_url": {
          "default": null,
          "description": "Temporary host-authorized download URL for this file",
          "type": "string"
        },
        "url": {
          "default": null,
          "description": "Temporary/public file URL when the host exposes one",
          "type": "string"
        },
        "uri": {
          "default": null,
          "description": "Host file URI when available",
          "type": "string"
        },
        "file_id": {
          "default": null,
          "description": "Host file ID",
          "type": "string"
        },
        "mime_type": {
          "default": null,
          "description": "File MIME type, e.g. image/png",
          "type": "string"
        },
        "content_type": {
          "default": null,
          "description": "File content type, e.g. image/png",
          "type": "string"
        },
        "file_name": {
          "default": null,
          "description": "Original uploaded file name",
          "type": "string"
        },
        "name": {
          "default": null,
          "description": "Original uploaded file name when the host uses name",
          "type": "string"
        }
      },
      "type": "object"
    }
  },
  "description": "Input schema for uploading avatars/models from chat file references."
}

generate_avatar

Generate canonical reusable avatar/model design-sheet candidates from the provided person description. The result uses the same character-sheet template and creator path as the Uwear app. Use when the user has no saved avatars and explicitly asks Uwear to create a reusable model/avatar, especially for consistency across a shoot. Do not block a normal photoshoot on this; avatar/model is optional. If the user wants help inventing or enriching the person's description, call build_avatar_prompt first; if the user's prompt is already intentional and specific, pass it directly here. Pass model when the user requests a specific image model; otherwise the backend uses the cheapest active image generation model available to the account. After results complete, call save_generated_avatar on the chosen result to save it to the avatar library.

Parameters6

prompt	string	required	Description of the person to render as a reusable avatar design sheet
name	string	optional	Optional name to carry with the avatar generation
age_range	string	optional	Optional concrete age or age range for the avatar footer.
build	string	optional	Optional authoritative physical build for the avatar footer. When omitted, the canonical creator derives it from the resolved persona. Placeholder values and inference instructions are rejected.
model	string	optional	Optional image model slug or display name. Defaults to the cheapest active image generation model available to the account.
num_images	integer	optional	Number of avatar candidate images to generate

Raw schema

{
  "type": "object",
  "properties": {
    "prompt": {
      "description": "Description of the person to render as a reusable avatar design sheet",
      "minLength": 3,
      "type": "string"
    },
    "name": {
      "default": null,
      "description": "Optional name to carry with the avatar generation",
      "type": "string"
    },
    "age_range": {
      "default": null,
      "description": "Optional concrete age or age range for the avatar footer.",
      "maxLength": 20,
      "type": "string"
    },
    "build": {
      "default": null,
      "description": "Optional authoritative physical build for the avatar footer. When omitted, the canonical creator derives it from the resolved persona. Placeholder values and inference instructions are rejected.",
      "maxLength": 100,
      "type": "string"
    },
    "model": {
      "default": null,
      "description": "Optional image model slug or display name. Defaults to the cheapest active image generation model available to the account.",
      "type": "string"
    },
    "num_images": {
      "default": 1,
      "description": "Number of avatar candidate images to generate",
      "maximum": 4,
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "prompt"
  ],
  "description": "Input schema for generating reusable avatar/model candidates."
}

save_generated_avatar

Save a completed generate_avatar image result as a reusable avatar/model in the user's library. Use only after generate_avatar finishes and the user chooses a candidate. Normal text-to-image results are not eligible because they do not contain the avatar creator's reopenable inputs.

Parameters4

generation_result_id	integer	required	Completed image result ID returned by generate_avatar. Normal text-to-image results are not eligible because they do not contain reopenable avatar-creator inputs.
name	string	required	Name for the saved avatar/model
description	object	optional	Optional avatar metadata. If omitted, the system can analyze the image.
enhance_description	boolean	optional	Analyze the image to create avatar metadata when description is omitted

Raw schema

{
  "type": "object",
  "properties": {
    "generation_result_id": {
      "description": "Completed image result ID returned by generate_avatar. Normal text-to-image results are not eligible because they do not contain reopenable avatar-creator inputs.",
      "type": "integer"
    },
    "name": {
      "description": "Name for the saved avatar/model",
      "type": "string"
    },
    "description": {
      "default": null,
      "description": "Optional avatar metadata. If omitted, the system can analyze the image.",
      "additionalProperties": true,
      "type": "object"
    },
    "enhance_description": {
      "default": true,
      "description": "Analyze the image to create avatar metadata when description is omitted",
      "type": "boolean"
    }
  },
  "required": [
    "generation_result_id",
    "name"
  ],
  "description": "Input schema for saving a completed avatar generation result."
}

list_outfits

List user's outfits (saved garment combinations). Filter by garment IDs, active status, date range, or query against contained garments.

Parameters10

query	string	optional	Search outfit names and contained garments.
outfit_ids	array	optional	Filter to specific outfit IDs
clothing_item_ids	array	optional	Filter to outfits containing any of these garments
tag_ids	array	optional	Filter to outfits with any of these tags
is_active	string	optional	Filter by status: 'true', 'false', or 'both' (default: both)
start_date	string	optional	Filter: created on or after this date (ISO format)
end_date	string	optional	Filter: created on or before this date (ISO format)
sort	string	optional	Sort: 'field:direction'. Default: created_at:desc
page	integer	optional	Page number for pagination
limit	integer	optional	Number of items per page

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "default": null,
      "description": "Search outfit names and contained garments.",
      "minLength": 2,
      "type": "string"
    },
    "outfit_ids": {
      "default": null,
      "description": "Filter to specific outfit IDs",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "clothing_item_ids": {
      "default": null,
      "description": "Filter to outfits containing any of these garments",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "tag_ids": {
      "default": null,
      "description": "Filter to outfits with any of these tags",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "is_active": {
      "default": null,
      "description": "Filter by status: 'true', 'false', or 'both' (default: both)",
      "type": "string"
    },
    "start_date": {
      "default": null,
      "description": "Filter: created on or after this date (ISO format)",
      "type": "string"
    },
    "end_date": {
      "default": null,
      "description": "Filter: created on or before this date (ISO format)",
      "type": "string"
    },
    "sort": {
      "default": null,
      "description": "Sort: 'field:direction'. Default: created_at:desc",
      "type": "string"
    },
    "page": {
      "default": 1,
      "description": "Page number for pagination",
      "minimum": 1,
      "type": "integer"
    },
    "limit": {
      "default": 10,
      "description": "Number of items per page",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    }
  },
  "additionalProperties": false,
  "description": "Input schema for listing outfits."
}

create_outfit_from_garment_ids

Create an outfit from existing garment IDs. Pairs saved garments together into a saved outfit without uploading new images.

Parameters3

name	string	optional	Optional human-readable outfit name
clothing_item_ids	array	required	IDs of clothing items to combine into an outfit
is_active	boolean	optional	Whether the outfit should be immediately active

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "default": null,
      "description": "Optional human-readable outfit name",
      "maxLength": 100,
      "type": "string"
    },
    "clothing_item_ids": {
      "description": "IDs of clothing items to combine into an outfit",
      "items": {
        "type": "integer"
      },
      "minItems": 1,
      "type": "array"
    },
    "is_active": {
      "default": false,
      "description": "Whether the outfit should be immediately active",
      "type": "boolean"
    }
  },
  "required": [
    "clothing_item_ids"
  ],
  "description": "Input schema for creating an outfit from existing clothing item IDs."
}

build_avatar_prompt

Build a highly detailed prompt for generating a unique reusable avatar/model. Use this when the user wants help describing a person before image generation. If the user's prompt is already intentional and specific, Uwear can skip this and pass the user's wording directly to generate_avatar.

Parameters5

user_text	string	optional	User's rough description of the person/model. Leave empty when the user wants the backend to invent a unique avatar prompt.
model_slug	string	optional	Optional image model slug for context
camera	string	optional	Optional camera key for context, e.g. midshot
camera_label	string	optional	Optional human-readable camera label
aspect_ratio	string	optional	Optional aspect ratio for context, e.g. 9:16

Raw schema

{
  "type": "object",
  "properties": {
    "user_text": {
      "default": "",
      "description": "User's rough description of the person/model. Leave empty when the user wants the backend to invent a unique avatar prompt.",
      "type": "string"
    },
    "model_slug": {
      "default": null,
      "description": "Optional image model slug for context",
      "type": "string"
    },
    "camera": {
      "default": null,
      "description": "Optional camera key for context, e.g. midshot",
      "type": "string"
    },
    "camera_label": {
      "default": null,
      "description": "Optional human-readable camera label",
      "type": "string"
    },
    "aspect_ratio": {
      "default": null,
      "description": "Optional aspect ratio for context, e.g. 9:16",
      "type": "string"
    }
  },
  "description": "Input schema for building a reusable avatar/model generation prompt."
}

propose_outfits

Use Uwear's outfit proposer to create styled outfit combinations from selected garments. Returns candidate titles, clothing_item_ids, and short rationales; call create_outfit_from_garment_ids only after the user chooses a proposal to save.

Parameters3

clothing_item_ids	array	required	Accessible clothing item IDs to combine into outfit proposals
instructions	string	optional	Optional styling brief, occasion, season, constraints, or vibe
max_outfits	integer	optional	Maximum number of outfit proposals to return

Raw schema

{
  "type": "object",
  "properties": {
    "clothing_item_ids": {
      "description": "Accessible clothing item IDs to combine into outfit proposals",
      "items": {
        "type": "integer"
      },
      "maxItems": 100,
      "minItems": 1,
      "type": "array"
    },
    "instructions": {
      "default": null,
      "description": "Optional styling brief, occasion, season, constraints, or vibe",
      "maxLength": 2000,
      "type": "string"
    },
    "max_outfits": {
      "default": 6,
      "description": "Maximum number of outfit proposals to return",
      "maximum": 24,
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "clothing_item_ids"
  ],
  "description": "Input schema for proposing outfit combinations from selected garments."
}

list_locations

List reusable location/scene reference images by structured filters or query: IDs, tags, date range, and sort. Use when the user wants to pick a saved background/location reference for a generation.

Parameters9

query	string	optional	Hybrid search across location names, metadata, and visual attributes.
location_ids	array	optional	Filter to specific location IDs
tag_ids	array	optional	Filter to locations with any of these tags
start_date	string	optional	Filter: created on or after this date (ISO format)
end_date	string	optional	Filter: created on or before this date (ISO format)
sort	string	optional	Sort order: 'field:direction', e.g. 'created_at:desc', 'location_name:asc'. Default: created_at:desc
page	integer	optional	Page number for pagination
limit	integer	optional	Number of items per page
include_image_url	boolean	optional	Set true when the location/reference image URL is needed for inspection or reuse.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "default": null,
      "description": "Hybrid search across location names, metadata, and visual attributes.",
      "minLength": 2,
      "type": "string"
    },
    "location_ids": {
      "default": null,
      "description": "Filter to specific location IDs",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "tag_ids": {
      "default": null,
      "description": "Filter to locations with any of these tags",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "start_date": {
      "default": null,
      "description": "Filter: created on or after this date (ISO format)",
      "type": "string"
    },
    "end_date": {
      "default": null,
      "description": "Filter: created on or before this date (ISO format)",
      "type": "string"
    },
    "sort": {
      "default": null,
      "description": "Sort order: 'field:direction', e.g. 'created_at:desc', 'location_name:asc'. Default: created_at:desc",
      "type": "string"
    },
    "page": {
      "default": 1,
      "description": "Page number for pagination",
      "minimum": 1,
      "type": "integer"
    },
    "limit": {
      "default": 10,
      "description": "Number of items per page",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "include_image_url": {
      "default": false,
      "description": "Set true when the location/reference image URL is needed for inspection or reuse.",
      "type": "boolean"
    }
  },
  "additionalProperties": false,
  "description": "Input schema for listing reusable location/scene references."
}

get_location

Get a reusable location/scene reference by ID.

Parameters1

location_id

integer

required

The location ID to retrieve

Raw schema

{
  "type": "object",
  "properties": {
    "location_id": {
      "description": "The location ID to retrieve",
      "type": "integer"
    }
  },
  "required": [
    "location_id"
  ],
  "description": "Input schema for getting a specific reusable location."
}

create_location

Create a reusable location/scene reference from an image URL. If no description is supplied, the backend analyzes the image. Use the returned location_id in propose_brief/update_brief.

Parameters6

name	string	required	Name for the reusable location/scene reference
image_url	string	required	URL of the location/reference image
description	string	optional	Optional location description. If omitted, the system analyzes the image.
thumbnail_url	string	optional	Optional thumbnail URL
source_metadata	object	optional	Optional provenance metadata for the source image
tag_ids	array	optional	Optional tag IDs to assign after creating the location

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Name for the reusable location/scene reference",
      "minLength": 1,
      "type": "string"
    },
    "image_url": {
      "description": "URL of the location/reference image",
      "type": "string"
    },
    "description": {
      "default": null,
      "description": "Optional location description. If omitted, the system analyzes the image.",
      "type": "string"
    },
    "thumbnail_url": {
      "default": null,
      "description": "Optional thumbnail URL",
      "type": "string"
    },
    "source_metadata": {
      "default": null,
      "description": "Optional provenance metadata for the source image",
      "additionalProperties": {
        "type": "string"
      },
      "type": "object"
    },
    "tag_ids": {
      "default": null,
      "description": "Optional tag IDs to assign after creating the location",
      "items": {
        "type": "integer"
      },
      "type": "array"
    }
  },
  "required": [
    "name",
    "image_url"
  ],
  "description": "Input schema for creating a reusable location/scene reference."
}

update_garment

Update a garment's metadata or patch its product photos. Send image changes through assets[] with front/back/side/detail roles. Provided front/back assets replace those singleton roles; provided side/detail assets are added. Omitted existing assets are preserved.

Parameters25

clothing_item_id	integer	required	The garment ID to update
name	string	optional	Updated garment name
description	string	optional	Updated item-level garment description, or a hint to use when patching images
gender	string	optional	Updated target gender: male, female, or unisex
assets	array	optional	Asset patch for garment product photos. A provided full front/back/side replaces that unique view; provided detail assets are added. Omitted existing assets are preserved.
image_file_1	any	optional	Generic top-level MCP file object for assets[].image_file references
image_file_2	any	optional	Generic top-level MCP file object for assets[].image_file references
image_file_3	any	optional	Generic top-level MCP file object for assets[].image_file references
image_file_4	any	optional	Generic top-level MCP file object for assets[].image_file references
image_file_5	any	optional	Generic top-level MCP file object for assets[].image_file references
image_file_6	any	optional	Generic top-level MCP file object for assets[].image_file references
image_file_7	any	optional	Generic top-level MCP file object for assets[].image_file references
image_file_8	any	optional	Generic top-level MCP file object for assets[].image_file references
image_file_9	any	optional	Generic top-level MCP file object for assets[].image_file references
image_file_10	any	optional	Generic top-level MCP file object for assets[].image_file references
image_file_11	any	optional	Generic top-level MCP file object for assets[].image_file references
image_file_12	any	optional	Generic top-level MCP file object for assets[].image_file references
image_file_13	any	optional	Generic top-level MCP file object for assets[].image_file references
image_file_14	any	optional	Generic top-level MCP file object for assets[].image_file references
image_file_15	any	optional	Generic top-level MCP file object for assets[].image_file references
image_file_16	any	optional	Generic top-level MCP file object for assets[].image_file references
image_file_17	any	optional	Generic top-level MCP file object for assets[].image_file references
image_file_18	any	optional	Generic top-level MCP file object for assets[].image_file references
image_file_19	any	optional	Generic top-level MCP file object for assets[].image_file references
image_file_20	any	optional	Generic top-level MCP file object for assets[].image_file references

Raw schema

{
  "type": "object",
  "properties": {
    "clothing_item_id": {
      "description": "The garment ID to update",
      "type": "integer"
    },
    "name": {
      "default": null,
      "description": "Updated garment name",
      "minLength": 1,
      "type": "string"
    },
    "description": {
      "default": null,
      "description": "Updated item-level garment description, or a hint to use when patching images",
      "type": "string"
    },
    "gender": {
      "default": null,
      "description": "Updated target gender: male, female, or unisex",
      "type": "string"
    },
    "assets": {
      "default": null,
      "description": "Asset patch for garment product photos. A provided full front/back/side replaces that unique view; provided detail assets are added. Omitted existing assets are preserved.",
      "items": {
        "$ref": "#/$defs/UpdateGarmentAssetInput"
      },
      "type": "array"
    },
    "image_file_1": {
      "default": null,
      "description": "Generic top-level MCP file object for assets[].image_file references"
    },
    "image_file_2": {
      "default": null,
      "description": "Generic top-level MCP file object for assets[].image_file references"
    },
    "image_file_3": {
      "default": null,
      "description": "Generic top-level MCP file object for assets[].image_file references"
    },
    "image_file_4": {
      "default": null,
      "description": "Generic top-level MCP file object for assets[].image_file references"
    },
    "image_file_5": {
      "default": null,
      "description": "Generic top-level MCP file object for assets[].image_file references"
    },
    "image_file_6": {
      "default": null,
      "description": "Generic top-level MCP file object for assets[].image_file references"
    },
    "image_file_7": {
      "default": null,
      "description": "Generic top-level MCP file object for assets[].image_file references"
    },
    "image_file_8": {
      "default": null,
      "description": "Generic top-level MCP file object for assets[].image_file references"
    },
    "image_file_9": {
      "default": null,
      "description": "Generic top-level MCP file object for assets[].image_file references"
    },
    "image_file_10": {
      "default": null,
      "description": "Generic top-level MCP file object for assets[].image_file references"
    },
    "image_file_11": {
      "default": null,
      "description": "Generic top-level MCP file object for assets[].image_file references"
    },
    "image_file_12": {
      "default": null,
      "description": "Generic top-level MCP file object for assets[].image_file references"
    },
    "image_file_13": {
      "default": null,
      "description": "Generic top-level MCP file object for assets[].image_file references"
    },
    "image_file_14": {
      "default": null,
      "description": "Generic top-level MCP file object for assets[].image_file references"
    },
    "image_file_15": {
      "default": null,
      "description": "Generic top-level MCP file object for assets[].image_file references"
    },
    "image_file_16": {
      "default": null,
      "description": "Generic top-level MCP file object for assets[].image_file references"
    },
    "image_file_17": {
      "default": null,
      "description": "Generic top-level MCP file object for assets[].image_file references"
    },
    "image_file_18": {
      "default": null,
      "description": "Generic top-level MCP file object for assets[].image_file references"
    },
    "image_file_19": {
      "default": null,
      "description": "Generic top-level MCP file object for assets[].image_file references"
    },
    "image_file_20": {
      "default": null,
      "description": "Generic top-level MCP file object for assets[].image_file references"
    }
  },
  "required": [
    "clothing_item_id"
  ],
  "$defs": {
    "UpdateGarmentAssetInput": {
      "description": "One classified garment asset patch.",
      "properties": {
        "asset_kind": {
          "default": null,
          "description": "Asset kind: full garment view or detail crop.",
          "enum": [
            "full",
            "detail"
          ],
          "type": "string"
        },
        "asset_view": {
          "default": null,
          "description": "Visible garment view. New detail uploads require front, back, or side.",
          "enum": [
            "front",
            "back",
            "side",
            "unspecified"
          ],
          "type": "string"
        },
        "asset_role": {
          "default": null,
          "deprecated": true,
          "description": "Deprecated role-only adapter. Prefer asset_kind and asset_view.",
          "enum": [
            "front",
            "back",
            "side",
            "detail"
          ],
          "type": "string"
        },
        "asset_url": {
          "default": null,
          "description": "Public HTTP(S) image URL for this asset",
          "type": "string"
        },
        "image_file": {
          "default": null,
          "description": "MCP host file object, or the name of a generic top-level file param such as image_file_1."
        },
        "file_name": {
          "default": null,
          "description": "Original file name for this asset",
          "type": "string"
        },
        "mime_type": {
          "default": null,
          "description": "MIME/content type for this asset, e.g. image/png",
          "type": "string"
        }
      },
      "type": "object"
    }
  },
  "description": "Input schema for updating garment metadata and images."
}

create_tag

Create a new tag for organizing assets (garments, models, outfits, files, results, locations). Requires an active company workspace.

Parameters2

name	string	required	Tag name (unique within the company)
color	string	optional	Optional hex color, e.g. '#22C55E'

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Tag name (unique within the company)",
      "maxLength": 100,
      "minLength": 1,
      "type": "string"
    },
    "color": {
      "default": null,
      "description": "Optional hex color, e.g. '#22C55E'",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "description": "Input schema for creating a tag."
}

get_generation_status

Check generation job status. Completed results may include labeled native ImageContent previews; use them directly and never Markdown-embed result URLs. They are display previews, not originals: url/download_url are originals, preview_url is the fallback link, and poster_url/thumbnail_url is a video poster. Returns status, raw payload, settings, avatar_id, model_id, model_slug, use_case, credits_charged, estimated_processing_seconds, and status_guidance. Status can remain Created while queued/preparing; avoid tight polling loops. UI 'Gemini Pro' maps to model_slug nano-banana-pro or nano_banana_pro_clothing.

Parameters1

generation_id

integer

required

The generation ID to check. Returns raw payload, generation_setting, avatar_id, model_id, model_slug, and use_case. UI 'Gemini Pro' maps to model_slug nano-banana-pro or nano_banana_pro_clothing.

Raw schema

{
  "type": "object",
  "properties": {
    "generation_id": {
      "description": "The generation ID to check. Returns raw payload, generation_setting, avatar_id, model_id, model_slug, and use_case. UI 'Gemini Pro' maps to model_slug nano-banana-pro or nano_banana_pro_clothing.",
      "type": "integer"
    }
  },
  "required": [
    "generation_id"
  ],
  "description": "Input schema for checking generation status."
}

get_generation_results

Look up generation results by exact IDs, filters, or hybrid image/name/SKU search. Returns labeled native ImageContent previews; use them directly and never Markdown-embed result URLs. They are display previews, not originals: url/download_url are originals, preview_url is the fallback link, and poster_url/thumbnail_url is a video poster. Every result includes generation_result_id and the response includes generation_result_ids; use those exact integers for queue_generation_result_qa/read_generation_result_qa or as durable generation_result command.source values in canonical edit, upscale, and video commands. Confirmation-gated clients use propose_brief(commands=[...], execute_immediately=true) when the user asked to run now, update_brief for a complete command replacement, or confirm_brief(execute=true) for a visible brief. Pass generation_result_id to fetch one result or generation_id to list a job's results. Returns raw payload when available so prior prompts can be recovered. Use start_date/end_date for requests like 'last week'.

Parameters17

generation_result_id	integer	optional	Look up a single result image by its generation_result_id (the exact integer ID required by QA/edit/upscale/video tools). Returns that one result directly.
generation_id	integer	optional	Filter by parent generation ID (lists all result images from one generation job)
query	string	optional	Hybrid search across generated image content, originating item names, and SKUs.
page	integer	optional	Page number for pagination
limit	integer	optional	Number of items per page
avatar_ids	array	optional	Filter results to images generated with these avatars
location_ids	array	optional	Filter results to images generated with these locations
outfit_ids	array	optional	Filter results to images generated with these outfits
art_direction_ids	array	optional	Filter results to images generated with these art directions
model_ids	array	optional	Filter results to images generated with these AI models
clothing_item_ids	array	optional	Filter results to images generated with these clothing items
tag_ids	array	optional	Filter by tag IDs (results must have at least one)
kind	string	optional	Filter by type: 'Image', 'Edit', 'Upscale', 'Video'
start_date	string	optional	Filter results created on or after this ISO date/datetime, e.g. 2026-04-20.
end_date	string	optional	Filter results created on or before this ISO date/datetime, e.g. 2026-04-27.
qa_decision	boolean	optional	Filter by QA decision. true = accepted, false = rejected.
qa_statuses	array	optional	Filter by QA statuses, e.g. pending, processing, completed, error.

Raw schema

{
  "type": "object",
  "properties": {
    "generation_result_id": {
      "default": null,
      "description": "Look up a single result image by its generation_result_id (the exact integer ID required by QA/edit/upscale/video tools). Returns that one result directly.",
      "type": "integer"
    },
    "generation_id": {
      "default": null,
      "description": "Filter by parent generation ID (lists all result images from one generation job)",
      "type": "integer"
    },
    "query": {
      "default": null,
      "description": "Hybrid search across generated image content, originating item names, and SKUs.",
      "minLength": 2,
      "type": "string"
    },
    "page": {
      "default": 1,
      "description": "Page number for pagination",
      "minimum": 1,
      "type": "integer"
    },
    "limit": {
      "default": 20,
      "description": "Number of items per page",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "avatar_ids": {
      "default": null,
      "description": "Filter results to images generated with these avatars",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "location_ids": {
      "default": null,
      "description": "Filter results to images generated with these locations",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "outfit_ids": {
      "default": null,
      "description": "Filter results to images generated with these outfits",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "art_direction_ids": {
      "default": null,
      "description": "Filter results to images generated with these art directions",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "model_ids": {
      "default": null,
      "description": "Filter results to images generated with these AI models",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "clothing_item_ids": {
      "default": null,
      "description": "Filter results to images generated with these clothing items",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "tag_ids": {
      "default": null,
      "description": "Filter by tag IDs (results must have at least one)",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "kind": {
      "default": null,
      "description": "Filter by type: 'Image', 'Edit', 'Upscale', 'Video'",
      "type": "string"
    },
    "start_date": {
      "default": null,
      "description": "Filter results created on or after this ISO date/datetime, e.g. 2026-04-20.",
      "type": "string"
    },
    "end_date": {
      "default": null,
      "description": "Filter results created on or before this ISO date/datetime, e.g. 2026-04-27.",
      "type": "string"
    },
    "qa_decision": {
      "default": null,
      "description": "Filter by QA decision. true = accepted, false = rejected.",
      "type": "boolean"
    },
    "qa_statuses": {
      "default": null,
      "description": "Filter by QA statuses, e.g. pending, processing, completed, error.",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "description": "Input schema for listing generation results."
}

queue_generation_result_qa

Default tool for generation-result QA. Use this whenever the user asks to QA, quality check, validate, review, inspect for defects, approve/reject, or assess already-created generation results. Do not substitute view_image for QA unless the user explicitly asks for a manual visual critique instead of the official Uwear QA pipeline. First identify the numeric generation_result_ids, then call this tool, then call read_generation_result_qa for the same IDs. Queued or requeued QA costs 1 credit per generation result; already-completed QA rows are not charged again. QA is built for scale — validating large batches (hundreds or thousands of results). When the user is iterating on a handful of results one by one, do not queue QA on your own initiative; run it when the user asks for it or when operating at batch scale.

Parameters2

generation_result_ids	array	required	Generation result IDs to QA. Queued or requeued QA costs 1 credit per result.
max_qa_retries	integer	optional	Maximum QA-triggered retry generations to allow. Retry generations can cost additional generation credits.

Raw schema

{
  "type": "object",
  "properties": {
    "generation_result_ids": {
      "description": "Generation result IDs to QA. Queued or requeued QA costs 1 credit per result.",
      "items": {
        "type": "integer"
      },
      "maxItems": 50,
      "minItems": 1,
      "type": "array"
    },
    "max_qa_retries": {
      "default": 0,
      "description": "Maximum QA-triggered retry generations to allow. Retry generations can cost additional generation credits.",
      "maximum": 5,
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "generation_result_ids"
  ],
  "description": "Input schema for queueing QA on existing generation results."
}

read_generation_result_qa

Read official Uwear QA status, decision, and structured QA JSON for existing generation results. Call this after queue_generation_result_qa when the user asks to QA/check/validate/review generated outputs; summarize the structured decision and issues, not a manual view_image opinion.

Parameters1

generation_result_ids

array

required

Generation result IDs to read QA for

Raw schema

{
  "type": "object",
  "properties": {
    "generation_result_ids": {
      "description": "Generation result IDs to read QA for",
      "items": {
        "type": "integer"
      },
      "maxItems": 50,
      "minItems": 1,
      "type": "array"
    }
  },
  "required": [
    "generation_result_ids"
  ],
  "description": "Input schema for reading QA rows for generation results."
}

download_generation_results

Bundle generation results into a ZIP and return a time-limited download URL. Use when the user wants to download or export their generated images/videos.

Parameters2

generation_result_ids	array	required	Generation result IDs to include in the ZIP
export_format	string	optional	Optional export format conversion, e.g. 'png' or 'jpg'

Raw schema

{
  "type": "object",
  "properties": {
    "generation_result_ids": {
      "description": "Generation result IDs to include in the ZIP",
      "items": {
        "type": "integer"
      },
      "maxItems": 200,
      "minItems": 1,
      "type": "array"
    },
    "export_format": {
      "default": null,
      "description": "Optional export format conversion, e.g. 'png' or 'jpg'",
      "type": "string"
    }
  },
  "required": [
    "generation_result_ids"
  ],
  "description": "Input schema for bundling generation results into a downloadable ZIP."
}

view_image

Analyze any image using AI vision for manual inspection, debugging, visual description, or supplemental critique. Do not use this as the primary QA mechanism when the user asks to QA, quality-check, validate, review, approve/reject, or assess generated results; for QA requests use queue_generation_result_qa first, then read_generation_result_qa. Prefer generation_result_id for Shoot Board generation items, uploaded_file_id for Files items, or pass a public HTTPS image URL directly.

Parameters4

image_url	string	optional	Public HTTPS image URL to analyze. Optional if generation_result_id or uploaded_file_id is provided.
generation_result_id	integer	optional	ID of an existing generation result to analyze. Preferred for Shoot Board generation items because the server resolves the HTTPS image URL.
uploaded_file_id	integer	optional	ID of an uploaded file to analyze. Use for items from the Files library.
question	string	required	What to analyze: e.g. 'Is this a flat lay or worn on a model?', 'Does this need background removal?', 'Describe the garment details'. Do not use this as the primary tool for generation-result QA; use queue_generation_result_qa and read_generation_result_qa for QA requests.

Raw schema

{
  "type": "object",
  "properties": {
    "image_url": {
      "default": null,
      "description": "Public HTTPS image URL to analyze. Optional if generation_result_id or uploaded_file_id is provided.",
      "type": "string"
    },
    "generation_result_id": {
      "default": null,
      "description": "ID of an existing generation result to analyze. Preferred for Shoot Board generation items because the server resolves the HTTPS image URL.",
      "type": "integer"
    },
    "uploaded_file_id": {
      "default": null,
      "description": "ID of an uploaded file to analyze. Use for items from the Files library.",
      "type": "integer"
    },
    "question": {
      "description": "What to analyze: e.g. 'Is this a flat lay or worn on a model?', 'Does this need background removal?', 'Describe the garment details'. Do not use this as the primary tool for generation-result QA; use queue_generation_result_qa and read_generation_result_qa for QA requests.",
      "type": "string"
    }
  },
  "required": [
    "question"
  ],
  "description": "Input schema for viewing and analyzing any image using AI vision."
}

propose_montage

ONLY for video montage/stitching/export workflows. Use when the user explicitly asks to create a montage, stitch clips, make a reel, export a video sequence, make video clips from images, or combine images/videos into one final video. Never use this for a photoshoot, lookbook, product shoot, collection shoot, outfit shoot, garment shoot, or image-generation request; those must use request_user_context followed by propose_brief/update_brief. Do not call this merely because selected context contains images, generations, garments, or models. A photoshoot may later feed a montage, but the photoshoot itself must be proposed as a BriefProposal first. PROPOSES the montage for user review — user can edit clips, generate missing videos, then export. Supports: existing videos with optional trim (`target_duration` or `start_time`/`end_time`), images that need video generation (specify video_model + a bespoke per-image motion prompt, and optionally `target_duration` or `duration`), per-clip speed/mute, global aspect ratio. If the user asks for clips to be e.g. '3 seconds each', set `target_duration: 3` on every item, including image items. For image items, avoid generic repeated prompts: tailor each prompt to the specific image and any requested zoom, movement, energy, or camera direction. If motion is not specified, inspect the image first with view_image and then write a fitting motion prompt from the image content before proposing. The user reviews and confirms in the UI. Export is free (0 credits); video generation clips cost credits per their model.

Parameters3

items	array	required	Ordered list of montage items. Each is either an existing video or an image needing video generation. Min 1, max 10.
aspect_ratio	string	optional	Output aspect ratio (e.g. '9:16', '16:9', '1:1')
base_resolution	integer	optional	Output resolution height in pixels

Raw schema

{
  "type": "object",
  "properties": {
    "items": {
      "description": "Ordered list of montage items. Each is either an existing video or an image needing video generation. Min 1, max 10.",
      "items": {
        "$ref": "#/$defs/MontageItemInput"
      },
      "maxItems": 10,
      "minItems": 1,
      "type": "array"
    },
    "aspect_ratio": {
      "default": "9:16",
      "description": "Output aspect ratio (e.g. '9:16', '16:9', '1:1')",
      "type": "string"
    },
    "base_resolution": {
      "default": 1080,
      "description": "Output resolution height in pixels",
      "maximum": 4320,
      "minimum": 360,
      "type": "integer"
    }
  },
  "required": [
    "items"
  ],
  "$defs": {
    "MontageItemInput": {
      "description": "A single item in a montage proposal. Either an existing video or an image to generate video from.",
      "properties": {
        "type": {
          "description": "'video' for existing video, 'image' for an image that needs video generation first",
          "enum": [
            "video",
            "image"
          ],
          "type": "string"
        },
        "video_result_id": {
          "default": null,
          "description": "ID of video GenerationResult (required when type='video')",
          "type": "integer"
        },
        "image_result_id": {
          "default": null,
          "description": "ID of image GenerationResult to use as first frame (required when type='image')",
          "type": "integer"
        },
        "image_url": {
          "default": null,
          "description": "URL of image to use as first frame (alternative to image_result_id)",
          "type": "string"
        },
        "video_model": {
          "default": null,
          "description": "Video model slug (required when type='image'). Use list_models(model_type='video') to see options.",
          "type": "string"
        },
        "prompt": {
          "default": null,
          "description": "Per-image motion prompt for video generation. Make it specific to this image and the requested movement, camera motion, vibe, and pacing.",
          "type": "string"
        },
        "duration": {
          "default": null,
          "description": "Exact generated video duration in seconds for image items. If omitted, target_duration can be used instead.",
          "type": "integer"
        },
        "last_frame_url": {
          "default": null,
          "description": "URL of last frame image for first-to-last video generation",
          "type": "string"
        },
        "generate_audio": {
          "default": false,
          "description": "Generate audio with the video",
          "type": "boolean"
        },
        "target_duration": {
          "default": null,
          "description": "Desired final clip length in seconds. For existing videos, this trims from the start by default. For image items, this becomes the generated video duration.",
          "exclusiveMinimum": 0,
          "type": "number"
        },
        "start_time": {
          "default": null,
          "description": "Optional trim start time in seconds for this clip",
          "minimum": 0,
          "type": "number"
        },
        "end_time": {
          "default": null,
          "description": "Optional trim end time in seconds for this clip",
          "exclusiveMinimum": 0,
          "type": "number"
        },
        "speed": {
          "default": 1,
          "description": "Playback speed multiplier (0.25-4.0)",
          "maximum": 4,
          "minimum": 0.25,
          "type": "number"
        },
        "muted": {
          "default": false,
          "description": "Mute audio for this item",
          "type": "boolean"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "description": "Input schema for proposing a montage (mix of existing videos and images to generate)."
}

update_montage_proposal

Patch the latest MontageProposal already shown in the UI. Use only for an existing video montage/reel/stitched sequence proposal; do not use this to modify a photoshoot brief. For photoshoot brief changes, call update_brief instead. Prefer `operations`, an ordered list of typed montage edits such as `clear_trim`, `remove`, `set_duration`, `set_trim_range`, `set_speed`, `set_muted`, `set_prompt`, `set_video_model`, `set_generate_audio`, `set_last_frame`, `set_aspect_ratio`, and `set_base_resolution`. Use `set_trim_range` for requests like 'use the second half', 'start at 3s', or 'trim from 3s to 6s'. Operations are applied in order to the current montage state. Legacy flat fields are still accepted as a compatibility shim. This updates the proposal only; it does not execute export or generation.

Parameters17

operations	array	optional	Ordered montage patch operations. Preferred over the legacy flat fields below.
clip_number	integer	optional	1-based clip number to update. Omit when apply_to_all=true.
clip_numbers	array	optional	Optional list of 1-based clip numbers to update together.
apply_to_all	boolean	optional	Apply changes to every clip in the current montage proposal.
remove	boolean	optional	Remove the selected clip(s) from the proposal.
clear_trim	boolean	optional	For video clips, remove trim bounds and restore the full clip length in the proposal.
target_duration	number	optional	Desired final clip length in seconds.
start_time	number	optional	Trim start time in seconds for legacy trim-range updates.
end_time	number	optional	Trim end time in seconds for legacy trim-range updates.
speed	number	optional	Playback speed multiplier.
muted	boolean	optional	Mute or unmute the selected clip(s).
prompt	string	optional	Update the motion prompt for image-to-video montage items.
video_model	string	optional	Update the video model for image-to-video montage items.
generate_audio	boolean	optional	Enable or disable generated audio for image-to-video montage items.
last_frame_url	string	optional	Optional last-frame URL for image-to-video montage items.
aspect_ratio	string	optional	Update the montage output aspect ratio.
base_resolution	integer	optional	Update the montage output resolution height.

Raw schema

{
  "type": "object",
  "properties": {
    "operations": {
      "default": null,
      "description": "Ordered montage patch operations. Preferred over the legacy flat fields below.",
      "items": {
        "$ref": "#/$defs/MontagePatchOpInput"
      },
      "type": "array"
    },
    "clip_number": {
      "default": null,
      "description": "1-based clip number to update. Omit when apply_to_all=true.",
      "minimum": 1,
      "type": "integer"
    },
    "clip_numbers": {
      "default": null,
      "description": "Optional list of 1-based clip numbers to update together.",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "apply_to_all": {
      "default": false,
      "description": "Apply changes to every clip in the current montage proposal.",
      "type": "boolean"
    },
    "remove": {
      "default": false,
      "description": "Remove the selected clip(s) from the proposal.",
      "type": "boolean"
    },
    "clear_trim": {
      "default": false,
      "description": "For video clips, remove trim bounds and restore the full clip length in the proposal.",
      "type": "boolean"
    },
    "target_duration": {
      "default": null,
      "description": "Desired final clip length in seconds.",
      "exclusiveMinimum": 0,
      "type": "number"
    },
    "start_time": {
      "default": null,
      "description": "Trim start time in seconds for legacy trim-range updates.",
      "minimum": 0,
      "type": "number"
    },
    "end_time": {
      "default": null,
      "description": "Trim end time in seconds for legacy trim-range updates.",
      "exclusiveMinimum": 0,
      "type": "number"
    },
    "speed": {
      "default": null,
      "description": "Playback speed multiplier.",
      "maximum": 4,
      "minimum": 0.25,
      "type": "number"
    },
    "muted": {
      "default": null,
      "description": "Mute or unmute the selected clip(s).",
      "type": "boolean"
    },
    "prompt": {
      "default": null,
      "description": "Update the motion prompt for image-to-video montage items.",
      "type": "string"
    },
    "video_model": {
      "default": null,
      "description": "Update the video model for image-to-video montage items.",
      "type": "string"
    },
    "generate_audio": {
      "default": null,
      "description": "Enable or disable generated audio for image-to-video montage items.",
      "type": "boolean"
    },
    "last_frame_url": {
      "default": null,
      "description": "Optional last-frame URL for image-to-video montage items.",
      "type": "string"
    },
    "aspect_ratio": {
      "default": null,
      "description": "Update the montage output aspect ratio.",
      "type": "string"
    },
    "base_resolution": {
      "default": null,
      "description": "Update the montage output resolution height.",
      "maximum": 4320,
      "minimum": 360,
      "type": "integer"
    }
  },
  "$defs": {
    "MontagePatchOpInput": {
      "description": "A typed montage patch operation applied in order.",
      "properties": {
        "op": {
          "description": "Patch operation to apply to the montage proposal.",
          "enum": [
            "remove",
            "clear_trim",
            "set_duration",
            "set_trim_range",
            "set_speed",
            "set_muted",
            "set_prompt",
            "set_video_model",
            "set_generate_audio",
            "set_last_frame",
            "set_aspect_ratio",
            "set_base_resolution"
          ],
          "type": "string"
        },
        "clip_number": {
          "default": null,
          "description": "1-based clip number target.",
          "minimum": 1,
          "type": "integer"
        },
        "clip_numbers": {
          "default": null,
          "description": "Optional list of 1-based clip numbers to target together.",
          "items": {
            "type": "integer"
          },
          "type": "array"
        },
        "apply_to_all": {
          "default": false,
          "description": "Apply this operation to every clip in the current montage proposal.",
          "type": "boolean"
        },
        "target_duration": {
          "default": null,
          "description": "Desired final clip length in seconds for set_duration.",
          "exclusiveMinimum": 0,
          "type": "number"
        },
        "start_time": {
          "default": null,
          "description": "Trim start time in seconds for set_trim_range.",
          "minimum": 0,
          "type": "number"
        },
        "end_time": {
          "default": null,
          "description": "Trim end time in seconds for set_trim_range.",
          "exclusiveMinimum": 0,
          "type": "number"
        },
        "speed": {
          "default": null,
          "description": "Playback speed multiplier for set_speed.",
          "maximum": 4,
          "minimum": 0.25,
          "type": "number"
        },
        "muted": {
          "default": null,
          "description": "Muted value for set_muted.",
          "type": "boolean"
        },
        "prompt": {
          "default": null,
          "description": "Motion prompt for set_prompt.",
          "type": "string"
        },
        "video_model": {
          "default": null,
          "description": "Video model for set_video_model.",
          "type": "string"
        },
        "generate_audio": {
          "default": null,
          "description": "Generate-audio value for set_generate_audio.",
          "type": "boolean"
        },
        "last_frame_url": {
          "default": null,
          "description": "Last-frame URL for set_last_frame.",
          "type": "string"
        },
        "aspect_ratio": {
          "default": null,
          "description": "Aspect ratio value for set_aspect_ratio.",
          "type": "string"
        },
        "base_resolution": {
          "default": null,
          "description": "Resolution value for set_base_resolution.",
          "maximum": 4320,
          "minimum": 360,
          "type": "integer"
        }
      },
      "required": [
        "op"
      ],
      "type": "object"
    }
  },
  "description": "Patch the latest montage proposal shown in the UI."
}

estimate_cost

Estimate credit cost for an operation.

Parameters6

operation	string	required	Operation: generate, edit, upscale, video
num_items	integer	optional	Number of items/images
model	string	optional	Specific model to use
duration	integer	optional	Video duration in seconds (video only, e.g. 4, 5, 6, 8, 10)
generate_audio	boolean	optional	Whether to generate audio (video only, doubles cost for most models)
resolution	string	optional	Output resolution when supported by the selected image or video model

Raw schema

{
  "type": "object",
  "properties": {
    "operation": {
      "description": "Operation: generate, edit, upscale, video",
      "type": "string"
    },
    "num_items": {
      "default": 1,
      "description": "Number of items/images",
      "minimum": 1,
      "type": "integer"
    },
    "model": {
      "default": null,
      "description": "Specific model to use",
      "type": "string"
    },
    "duration": {
      "default": null,
      "description": "Video duration in seconds (video only, e.g. 4, 5, 6, 8, 10)",
      "type": "integer"
    },
    "generate_audio": {
      "default": false,
      "description": "Whether to generate audio (video only, doubles cost for most models)",
      "type": "boolean"
    },
    "resolution": {
      "default": null,
      "description": "Output resolution when supported by the selected image or video model",
      "type": "string"
    }
  },
  "required": [
    "operation"
  ],
  "description": "Input schema for estimating operation cost."
}

get_user_credits

Get user's current credit balance.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

update_preferences

Update durable user preferences, photoshoot processes, or add a prompt. Treat all model fields as explicit model pins: leave model fields unset for normal backend defaults unless the user deliberately selected a specific model. The preferred way to save how a user generates is a template (save_template): a generation-preset template for reusable concrete single-shoot settings, a batch-workflow template for an ordered repeatable multi-shot flow — see the `Demo — …` system templates for worked examples. Use preferences for durable raw-text guidance that is not a concrete shoot setup.

Parameters2

preferences	object	optional	Preference key-value updates. Model fields (default_model, default_edit_model, default_upscale_model, default_video_model, and process-level model) are explicit pins only; leave them unset for backend defaults. Prefer a generation-preset template for reproducible concrete shoot settings and a batch-workflow template for an ordered multi-shot flow. Other fields include default_aspect_ratio, preferred_camera, default_resolution, photoshoot_processes, etc. Processes format: [{name, model, camera, aspect_ratio, resolution, prompt, num_images, pipeline: [{type, editModel, editPrompt, ...}], is_default}]
add_prompt	object	optional	Prompt to save: {text, category, is_favorite}

Raw schema

{
  "type": "object",
  "properties": {
    "preferences": {
      "default": null,
      "description": "Preference key-value updates. Model fields (default_model, default_edit_model, default_upscale_model, default_video_model, and process-level model) are explicit pins only; leave them unset for backend defaults. Prefer a generation-preset template for reproducible concrete shoot settings and a batch-workflow template for an ordered multi-shot flow. Other fields include default_aspect_ratio, preferred_camera, default_resolution, photoshoot_processes, etc. Processes format: [{name, model, camera, aspect_ratio, resolution, prompt, num_images, pipeline: [{type, editModel, editPrompt, ...}], is_default}]",
      "additionalProperties": true,
      "type": "object"
    },
    "add_prompt": {
      "default": null,
      "description": "Prompt to save: {text, category, is_favorite}",
      "additionalProperties": true,
      "type": "object"
    }
  },
  "description": "Input schema for updating user preferences."
}

list_tags

List available tags for the user's company. Use this to resolve user-provided tag names like 'summer26' before selecting garments, outfits, models, files, generations, or locations. For no-UI MCP flows, find the tag ID here, then call get_items_by_tag or the relevant list_* tool with tag_ids.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false,
  "description": "Input schema for listing available tags."
}

get_items_by_tag

Get all item IDs tagged with a specific tag, grouped by type. Use after list_tags for no-UI MCP requests like 'use my clothes tagged summer26'; then pass the resulting clothing_item IDs as garment_ids to propose_brief instead of opening request_user_context.

Parameters2

tag_id	integer	required	Tag ID to look up
item_types	array	optional	Filter to specific types: 'clothing_item', 'avatar', 'outfit', 'generation_result', 'location'. Omit to get all.

Raw schema

{
  "type": "object",
  "properties": {
    "tag_id": {
      "description": "Tag ID to look up",
      "type": "integer"
    },
    "item_types": {
      "default": null,
      "description": "Filter to specific types: 'clothing_item', 'avatar', 'outfit', 'generation_result', 'location'. Omit to get all.",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "tag_id"
  ],
  "description": "Input schema for querying items by tag across entity types."
}

request_user_context

FIRST tool to call for a new photoshoot only when the user has not supplied garment/outfit IDs or textual selectors such as tag names, saved ArtDirection names, location names, or outfit names. Opens the MCP app/gallery so the user can choose assets, add them to the Shoot Board, and press Confirm context. BLOCKS until the user confirms their selection. Do not use this when a no-UI path can resolve the request with list_tags/get_items_by_tag/list_garments or the ArtDirection lookup tools. Do not tell the user to drag assets into chat. If the user has no garments/outfits, ask them to attach garment/product images and use upload_garment_from_chat_file, upload_garment_from_public_url, or create_outfit_from_garment_ids before trying to create a brief. Do not request models when inventory shows avatars=0. Avatar/model is optional; only ask for one when the user wants a specific or consistent person. If they want a model and have none, ask for a person photo and use upload_avatar_from_chat_file, or use generate_avatar if they want Uwear to create a reusable model.

Parameters3

prompt	string	required	Instruction shown to the user, e.g. 'Select the clothing items you want to use and add them to the Shoot Board'
expected_types	array	required	Accepted item types (match panel tabs): 'clothing', 'models', 'outfits', 'generations', 'files'. Legacy 'file' is accepted as an alias for 'files'.
min_items	integer	optional	Minimum number of items the user must provide

Raw schema

{
  "type": "object",
  "properties": {
    "prompt": {
      "description": "Instruction shown to the user, e.g. 'Select the clothing items you want to use and add them to the Shoot Board'",
      "type": "string"
    },
    "expected_types": {
      "description": "Accepted item types (match panel tabs): 'clothing', 'models', 'outfits', 'generations', 'files'. Legacy 'file' is accepted as an alias for 'files'.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "min_items": {
      "default": 1,
      "description": "Minimum number of items the user must provide",
      "type": "integer"
    }
  },
  "required": [
    "prompt",
    "expected_types"
  ],
  "additionalProperties": false,
  "description": "Input schema for requesting user-selected items from the MCP app/gallery."
}

save_reference_file_from_chat_file

Batch save reference images from chat attachments into the Files library. Keep file metadata in files[] and pass top-level image_file_1, image_file_2, etc. in the same order. No base64, no local paths. Use for mood boards, backgrounds, and other reference images that are not garments or avatars.

Parameters14

files	array	optional	Reference file metadata in the same order as image_file_1, image_file_2, etc. No base64.
image_file_1	any	optional	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_2	any	optional	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_3	any	optional	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_4	any	optional	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_5	any	optional	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_6	any	optional	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_7	any	optional	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_8	any	optional	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_9	any	optional	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_file_10	any	optional	Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID.
image_url	string	optional	Single resolved download URL used by automatic opaque-file recovery.
file_name	string	optional	Single recovered display name
mime_type	string	optional	Single recovered MIME/content type, e.g. image/png

Raw schema

{
  "type": "object",
  "properties": {
    "files": {
      "default": null,
      "description": "Reference file metadata in the same order as image_file_1, image_file_2, etc. No base64.",
      "items": {
        "$ref": "#/$defs/ReferenceChatFileUploadItem"
      },
      "maxItems": 10,
      "type": "array"
    },
    "image_file_1": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID."
    },
    "image_file_2": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID."
    },
    "image_file_3": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID."
    },
    "image_file_4": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID."
    },
    "image_file_5": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID."
    },
    "image_file_6": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID."
    },
    "image_file_7": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID."
    },
    "image_file_8": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID."
    },
    "image_file_9": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID."
    },
    "image_file_10": {
      "anyOf": [
        {
          "$ref": "#/$defs/MCPFileReference"
        },
        {
          "type": "string"
        }
      ],
      "default": null,
      "description": "Host-provided uploaded file reference for the matching item index when it has no image_url. Use the file object supplied by the host, not a bare file_... ID."
    },
    "image_url": {
      "default": null,
      "description": "Single resolved download URL used by automatic opaque-file recovery.",
      "type": "string"
    },
    "file_name": {
      "default": null,
      "description": "Single recovered display name",
      "type": "string"
    },
    "mime_type": {
      "default": null,
      "description": "Single recovered MIME/content type, e.g. image/png",
      "type": "string"
    }
  },
  "$defs": {
    "MCPFileReference": {
      "additionalProperties": true,
      "description": "Host-provided MCP file reference for user-uploaded images.",
      "properties": {
        "download_url": {
          "default": null,
          "description": "Temporary host-authorized download URL for this file",
          "type": "string"
        },
        "url": {
          "default": null,
          "description": "Temporary/public file URL when the host exposes one",
          "type": "string"
        },
        "uri": {
          "default": null,
          "description": "Host file URI when available",
          "type": "string"
        },
        "file_id": {
          "default": null,
          "description": "Host file ID",
          "type": "string"
        },
        "mime_type": {
          "default": null,
          "description": "File MIME type, e.g. image/png",
          "type": "string"
        },
        "content_type": {
          "default": null,
          "description": "File content type, e.g. image/png",
          "type": "string"
        },
        "file_name": {
          "default": null,
          "description": "Original uploaded file name",
          "type": "string"
        },
        "name": {
          "default": null,
          "description": "Original uploaded file name when the host uses name",
          "type": "string"
        }
      },
      "type": "object"
    },
    "ReferenceChatFileUploadItem": {
      "description": "One reference file upload item for chat-file batch upload.",
      "properties": {
        "file_name": {
          "default": null,
          "description": "Display name for the saved reference file",
          "type": "string"
        },
        "name": {
          "default": null,
          "description": "Alternate display name for the saved reference file",
          "type": "string"
        },
        "mime_type": {
          "default": null,
          "description": "MIME/content type, e.g. image/png",
          "type": "string"
        },
        "image_url": {
          "default": null,
          "description": "Resolved download URL. Used by the Uwear app when recovering a chat file ID.",
          "type": "string"
        }
      },
      "type": "object"
    }
  },
  "description": "Input schema for saving reference files from chat file references."
}

propose_brief

Create a Uwear BriefProposal from canonical generation commands. Every commands[].input is the exact REST GenerationIntent contract; commands and immutable plans are persisted without translation. Supply a concrete model_slug for generate, edit, upscale, and video. Use durable command.source IDs for uploaded files or generation results, and reference_attachments for additional references. For video, attach available full back or side garment assets that the camera may reveal when capacity permits; having the asset uploaded is not enough. If the response contains video_garment_view_not_attached, explain its exact assets, node, and capacity, then follow its remediation. Never mix reference_attachments with img_ref_urls or append recommendations beyond remaining capacity. Set execute_immediately=true only when the user explicitly asks to run now. Include creative_context for photoshoots and explain the art direction after proposing. For changes to a visible brief, call update_brief with the complete replacement command list.

Parameters3

commands	array	required	Canonical generation commands. Each command contains the exact REST GenerationIntent contract and a durable source reference. Write each input.prompt as a compact positive scene description (setting, lighting, mood, camera, pose — for video, motion and camera movement); without art_direction_id the prompt is the entire creative direction, so give it the full scene. The attached garment/avatar/reference images carry product appearance, so never pad prompts with restated garment construction details, product-fidelity warnings, or negative 'do not' instruction blocks; styling intent (fit, tuck, drape) is fine. For video commands, attach available full back or side garment assets that the camera may reveal through input.reference_attachments when capacity permits. Do not combine reference_attachments with img_ref_urls; uploaded garment assets are not attached automatically.
creative_context	string	optional	Required for photoshoot proposals and brief rewrites. Summarize the shoot-level creative approach that guided garment combos, avatars, prompts, and pipeline steps. By default prefer one cohesive art direction across the photoshoot, e.g. 'urban summer editorial', 'standard grey e-commerce', or 'sporty studio catalog'. Per-look prompts may differ for garment details, pose, framing, or avatar, but should feel part of the same shoot unless the user explicitly asks for multiple art directions, split concepts, A/B routes, or varied campaign directions. The assistant should explain this art direction to the user after proposing the brief and ask if they want changes.
execute_immediately	boolean	optional	Set true only when the user explicitly asks to prepare/create/generate/run the photoshoot without another review step. When true, Uwear persists the brief, confirms it, and executes it directly if credits and validation allow; otherwise it falls back to the editable BriefProposal.

Raw schema

{
  "type": "object",
  "properties": {
    "commands": {
      "description": "Canonical generation commands. Each command contains the exact REST GenerationIntent contract and a durable source reference. Write each input.prompt as a compact positive scene description (setting, lighting, mood, camera, pose — for video, motion and camera movement); without art_direction_id the prompt is the entire creative direction, so give it the full scene. The attached garment/avatar/reference images carry product appearance, so never pad prompts with restated garment construction details, product-fidelity warnings, or negative 'do not' instruction blocks; styling intent (fit, tuck, drape) is fine. For video commands, attach available full back or side garment assets that the camera may reveal through input.reference_attachments when capacity permits. Do not combine reference_attachments with img_ref_urls; uploaded garment assets are not attached automatically.",
      "items": {
        "$ref": "#/$defs/GenerationCommand"
      },
      "minItems": 1,
      "type": "array"
    },
    "creative_context": {
      "default": null,
      "description": "Required for photoshoot proposals and brief rewrites. Summarize the shoot-level creative approach that guided garment combos, avatars, prompts, and pipeline steps. By default prefer one cohesive art direction across the photoshoot, e.g. 'urban summer editorial', 'standard grey e-commerce', or 'sporty studio catalog'. Per-look prompts may differ for garment details, pose, framing, or avatar, but should feel part of the same shoot unless the user explicitly asks for multiple art directions, split concepts, A/B routes, or varied campaign directions. The assistant should explain this art direction to the user after proposing the brief and ask if they want changes.",
      "type": "string"
    },
    "execute_immediately": {
      "default": false,
      "description": "Set true only when the user explicitly asks to prepare/create/generate/run the photoshoot without another review step. When true, Uwear persists the brief, confirms it, and executes it directly if credits and validation allow; otherwise it falls back to the editable BriefProposal.",
      "type": "boolean"
    }
  },
  "required": [
    "commands"
  ],
  "$defs": {
    "GenerationCommand": {
      "additionalProperties": false,
      "description": "Versioned command shared by REST, Agent, MCP, jobs, and briefs.\n\nThe nested ``input`` is intentionally the API's public intent model. A\nfield added there therefore appears automatically in this command's JSON\nschema, serialization, and persisted brief representation.",
      "properties": {
        "schema_version": {
          "const": 2,
          "type": "integer"
        },
        "input": {
          "$ref": "#/$defs/GenerationIntent"
        },
        "source": {
          "default": null,
          "discriminator": {
            "mapping": {
              "generation_result": "#/$defs/GenerationResultCommandSource",
              "pipeline_step": "#/$defs/PipelineStepCommandSource",
              "public_url": "#/$defs/PublicUrlCommandSource",
              "uploaded_file": "#/$defs/UploadedFileCommandSource"
            },
            "propertyName": "type"
          },
          "oneOf": [
            {
              "properties": {
                "type": {
                  "const": "generation_result",
                  "type": "string"
                },
                "generation_result_id": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "required": [
                "type",
                "generation_result_id"
              ],
              "type": "object"
            },
            {
              "properties": {
                "type": {
                  "const": "uploaded_file",
                  "type": "string"
                },
                "uploaded_file_id": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "required": [
                "type",
                "uploaded_file_id"
              ],
              "type": "object"
            },
            {
              "properties": {
                "type": {
                  "const": "public_url",
                  "type": "string"
                },
                "image_url": {
                  "minLength": 1,
                  "type": "string"
                }
              },
              "required": [
                "type",
                "image_url"
              ],
              "type": "object"
            },
            {
              "description": "Durable identity for a source produced by an earlier pipeline step.",
              "properties": {
                "type": {
                  "const": "pipeline_step",
                  "type": "string"
                },
                "post_claim_reference": {
                  "minLength": 1,
                  "type": "string"
                },
                "step_index": {
                  "minimum": 0,
                  "type": "integer"
                },
                "output_index": {
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "required": [
                "type",
                "post_claim_reference",
                "step_index",
                "output_index"
              ],
              "type": "object"
            }
          ],
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "enum": [
                "generation_result",
                "uploaded_file",
                "public_url",
                "pipeline_step"
              ]
            },
            "generation_result_id": {
              "minimum": 1,
              "type": "integer"
            },
            "uploaded_file_id": {
              "minimum": 1,
              "type": "integer"
            },
            "image_url": {
              "minLength": 1,
              "type": "string"
            },
            "post_claim_reference": {
              "minLength": 1,
              "type": "string"
            },
            "step_index": {
              "minimum": 0,
              "type": "integer"
            },
            "output_index": {
              "minimum": 0,
              "type": "integer"
            }
          }
        }
      },
      "required": [
        "schema_version",
        "input"
      ],
      "type": "object"
    },
    "GenerationIntent": {
      "additionalProperties": false,
      "description": "Caller-owned model-generation intent shared by every public adapter.\n\nAuthentication-derived identity deliberately does not belong here. REST,\nAgent, MCP, batch, and integrations all submit this exact contract; the\ncommand planner combines it with server-owned execution context later.",
      "properties": {
        "clothing_item_ids": {
          "default": null,
          "items": {
            "type": "integer"
          },
          "type": "array"
        },
        "outfit_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "num_images": {
          "minimum": 1,
          "type": "integer"
        },
        "prompt": {
          "default": "",
          "description": "Scene brief for this shot: setting, lighting, mood, camera/framing, pose — 2-5 compact positive sentences. Without art_direction_id this prompt reaches the image model as-is and is the entire creative direction: carry the shoot's world, lighting, and atmosphere here. With art_direction_id, the saved direction carries reusable style; add only per-shot intent. Supplied garment/avatar/reference images carry product appearance: refer to them semantically ('the supplied jacket'), never by image number — the backend appends the numbered reference map at dispatch. Styling intent (fit, tuck, drape, opening state) belongs here when it matters; re-described garment construction, product-fidelity warnings, and negative 'do not ...' blocks do not — with good references they degrade output. Say what to show, not what to avoid. Video commands: describe motion and camera movement. May be empty for upscale; generation routes validate separately.",
          "type": "string"
        },
        "camera": {
          "default": "",
          "type": "string"
        },
        "camera_edit_id": {
          "default": null,
          "type": "string"
        },
        "avatar_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "art_direction_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "location_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "generation_result_parent_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "enhance_user_prompt": {
          "default": null,
          "deprecated": true,
          "description": "Deprecated REST compatibility alias. true is normalized at command preparation to the legacy prompt-enhancement ArtDirection ID; false has no effect. Prefer art_direction_id. Removal requires 90 consecutive days without production use; usage was last observed on 2026-07-26.",
          "ui": {
            "editable": false,
            "visibility": [
              "rest"
            ]
          },
          "type": "boolean"
        },
        "image_url": {
          "default": null,
          "type": "string"
        },
        "tag_ids": {
          "default": null,
          "items": {
            "type": "integer"
          },
          "type": "array"
        },
        "children": {
          "default": null,
          "description": "Nested generation requests to run after this generation completes. Every child must provide model_slug.",
          "items": {
            "$ref": "#/$defs/GenerationIntent"
          },
          "type": "array"
        },
        "model_slug": {
          "description": "Active AI model slug. Required for every generation command.",
          "minLength": 1,
          "type": "string"
        },
        "use_case": {
          "default": null,
          "type": "string"
        },
        "webhook_url": {
          "default": null,
          "type": "string"
        },
        "webhook_secret": {
          "default": null,
          "description": "Optional HMAC signing secret for customer callbacks.",
          "ui": {
            "sensitive": true
          },
          "type": "string"
        },
        "webhook_events": {
          "default": null,
          "items": {
            "enum": [
              "generation.completed",
              "generation.failed"
            ],
            "type": "string"
          },
          "type": "array"
        },
        "do_qa": {
          "default": null,
          "description": "When true, enqueue QA after result storage and gate acceptance on QA.",
          "type": "boolean"
        },
        "max_qa_retries": {
          "default": null,
          "description": "Maximum QA-triggered retry generations after the initial attempt.",
          "maximum": 5,
          "minimum": 0,
          "type": "integer"
        },
        "resolution": {
          "default": null,
          "description": "Model-defined output resolution. Legacy image tiers are normalized to 1K, 2K, or 4K; video and exact pixel presets retain their model-defined casing.",
          "maxLength": 32,
          "minLength": 2,
          "type": "string"
        },
        "aspect_ratio": {
          "default": null,
          "type": "string"
        },
        "alignment": {
          "default": null,
          "enum": [
            "left",
            "center",
            "right",
            "top",
            "bottom"
          ],
          "type": "string"
        },
        "img_ref_urls": {
          "default": null,
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "reference_attachments": {
          "default": null,
          "items": {
            "$ref": "#/$defs/GenerationReferenceAttachmentInput"
          },
          "type": "array"
        },
        "duration": {
          "default": null,
          "type": "integer"
        },
        "generate_audio": {
          "default": false,
          "type": "boolean"
        },
        "last_frame_url": {
          "default": null,
          "type": "string"
        },
        "upscale_factor": {
          "default": null,
          "type": "number"
        },
        "target_resolution": {
          "default": null,
          "type": "string"
        },
        "seed": {
          "default": null,
          "type": "integer"
        },
        "negative_prompt": {
          "default": null,
          "type": "string"
        },
        "backdrop_mode": {
          "default": null,
          "description": "Canonical Backdrop mode for new generation requests.",
          "enum": [
            "transparent",
            "solid",
            "image"
          ],
          "type": "string"
        },
        "color_hex": {
          "default": null,
          "description": "Canonical Backdrop solid or fallback color.",
          "type": "string"
        },
        "background_image_url": {
          "default": null,
          "description": "Canonical Backdrop background image URL.",
          "type": "string"
        },
        "extra_params": {
          "default": null,
          "description": "Model-specific extension parameters. Backdrop controls are not accepted here; use backdrop_mode, color_hex, and background_image_url.",
          "additionalProperties": true,
          "type": "object"
        }
      },
      "required": [
        "num_images",
        "model_slug"
      ],
      "type": "object"
    },
    "GenerationReferenceAttachmentInput": {
      "properties": {
        "type": {
          "enum": [
            "uploaded_file",
            "generation_result",
            "location",
            "avatar",
            "clothing_item"
          ],
          "type": "string"
        },
        "uploaded_file_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "generation_result_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "location_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "avatar_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "clothing_item_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "clothing_item_asset_id": {
          "default": null,
          "description": "Exact durable clothing asset reference. Provide with clothing_item_id; preferred over the deprecated side selector for repeated detail assets.",
          "minimum": 1,
          "type": "integer"
        },
        "side": {
          "default": null,
          "enum": [
            "front",
            "back"
          ],
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    },
    "GenerationResultCommandSource": {
      "properties": {
        "type": {
          "const": "generation_result",
          "type": "string"
        },
        "generation_result_id": {
          "minimum": 1,
          "type": "integer"
        }
      },
      "required": [
        "type",
        "generation_result_id"
      ],
      "type": "object"
    },
    "PipelineStepCommandSource": {
      "description": "Durable identity for a source produced by an earlier pipeline step.",
      "properties": {
        "type": {
          "const": "pipeline_step",
          "type": "string"
        },
        "post_claim_reference": {
          "minLength": 1,
          "type": "string"
        },
        "step_index": {
          "minimum": 0,
          "type": "integer"
        },
        "output_index": {
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "type",
        "post_claim_reference",
        "step_index",
        "output_index"
      ],
      "type": "object"
    },
    "PublicUrlCommandSource": {
      "properties": {
        "type": {
          "const": "public_url",
          "type": "string"
        },
        "image_url": {
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "type",
        "image_url"
      ],
      "type": "object"
    },
    "UploadedFileCommandSource": {
      "properties": {
        "type": {
          "const": "uploaded_file",
          "type": "string"
        },
        "uploaded_file_id": {
          "minimum": 1,
          "type": "integer"
        }
      },
      "required": [
        "type",
        "uploaded_file_id"
      ],
      "type": "object"
    }
  },
  "description": "Propose a brief made exclusively of canonical generation commands."
}

update_brief

Replace the visible Uwear BriefProposal with a complete canonical command list. Edit commands[].input directly using the exact REST GenerationIntent fields and preserve every unchanged field and durable source. This is replacement state, not a partial diff. For video_garment_view_not_attached warnings, follow the capacity-aware remediation: never mix reference_attachments with img_ref_urls or append recommendations beyond remaining capacity. Include updated creative_context for photoshoot rewrites and explain the changed art direction.

Parameters2

commands	array	required	Canonical generation commands. Each command contains the exact REST GenerationIntent contract and a durable source reference. Write each input.prompt as a compact positive scene description (setting, lighting, mood, camera, pose — for video, motion and camera movement); without art_direction_id the prompt is the entire creative direction, so give it the full scene. The attached garment/avatar/reference images carry product appearance, so never pad prompts with restated garment construction details, product-fidelity warnings, or negative 'do not' instruction blocks; styling intent (fit, tuck, drape) is fine. For video commands, attach available full back or side garment assets that the camera may reveal through input.reference_attachments when capacity permits. Do not combine reference_attachments with img_ref_urls; uploaded garment assets are not attached automatically.
creative_context	string	optional	Required for photoshoot proposals and brief rewrites. Summarize the shoot-level creative approach that guided garment combos, avatars, prompts, and pipeline steps. By default prefer one cohesive art direction across the photoshoot, e.g. 'urban summer editorial', 'standard grey e-commerce', or 'sporty studio catalog'. Per-look prompts may differ for garment details, pose, framing, or avatar, but should feel part of the same shoot unless the user explicitly asks for multiple art directions, split concepts, A/B routes, or varied campaign directions. The assistant should explain this art direction to the user after proposing the brief and ask if they want changes.

Raw schema

{
  "type": "object",
  "properties": {
    "commands": {
      "description": "Canonical generation commands. Each command contains the exact REST GenerationIntent contract and a durable source reference. Write each input.prompt as a compact positive scene description (setting, lighting, mood, camera, pose — for video, motion and camera movement); without art_direction_id the prompt is the entire creative direction, so give it the full scene. The attached garment/avatar/reference images carry product appearance, so never pad prompts with restated garment construction details, product-fidelity warnings, or negative 'do not' instruction blocks; styling intent (fit, tuck, drape) is fine. For video commands, attach available full back or side garment assets that the camera may reveal through input.reference_attachments when capacity permits. Do not combine reference_attachments with img_ref_urls; uploaded garment assets are not attached automatically.",
      "items": {
        "$ref": "#/$defs/GenerationCommand"
      },
      "minItems": 1,
      "type": "array"
    },
    "creative_context": {
      "default": null,
      "description": "Required for photoshoot proposals and brief rewrites. Summarize the shoot-level creative approach that guided garment combos, avatars, prompts, and pipeline steps. By default prefer one cohesive art direction across the photoshoot, e.g. 'urban summer editorial', 'standard grey e-commerce', or 'sporty studio catalog'. Per-look prompts may differ for garment details, pose, framing, or avatar, but should feel part of the same shoot unless the user explicitly asks for multiple art directions, split concepts, A/B routes, or varied campaign directions. The assistant should explain this art direction to the user after proposing the brief and ask if they want changes.",
      "type": "string"
    }
  },
  "required": [
    "commands"
  ],
  "$defs": {
    "GenerationCommand": {
      "additionalProperties": false,
      "description": "Versioned command shared by REST, Agent, MCP, jobs, and briefs.\n\nThe nested ``input`` is intentionally the API's public intent model. A\nfield added there therefore appears automatically in this command's JSON\nschema, serialization, and persisted brief representation.",
      "properties": {
        "schema_version": {
          "const": 2,
          "type": "integer"
        },
        "input": {
          "$ref": "#/$defs/GenerationIntent"
        },
        "source": {
          "default": null,
          "discriminator": {
            "mapping": {
              "generation_result": "#/$defs/GenerationResultCommandSource",
              "pipeline_step": "#/$defs/PipelineStepCommandSource",
              "public_url": "#/$defs/PublicUrlCommandSource",
              "uploaded_file": "#/$defs/UploadedFileCommandSource"
            },
            "propertyName": "type"
          },
          "oneOf": [
            {
              "properties": {
                "type": {
                  "const": "generation_result",
                  "type": "string"
                },
                "generation_result_id": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "required": [
                "type",
                "generation_result_id"
              ],
              "type": "object"
            },
            {
              "properties": {
                "type": {
                  "const": "uploaded_file",
                  "type": "string"
                },
                "uploaded_file_id": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "required": [
                "type",
                "uploaded_file_id"
              ],
              "type": "object"
            },
            {
              "properties": {
                "type": {
                  "const": "public_url",
                  "type": "string"
                },
                "image_url": {
                  "minLength": 1,
                  "type": "string"
                }
              },
              "required": [
                "type",
                "image_url"
              ],
              "type": "object"
            },
            {
              "description": "Durable identity for a source produced by an earlier pipeline step.",
              "properties": {
                "type": {
                  "const": "pipeline_step",
                  "type": "string"
                },
                "post_claim_reference": {
                  "minLength": 1,
                  "type": "string"
                },
                "step_index": {
                  "minimum": 0,
                  "type": "integer"
                },
                "output_index": {
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "required": [
                "type",
                "post_claim_reference",
                "step_index",
                "output_index"
              ],
              "type": "object"
            }
          ],
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "enum": [
                "generation_result",
                "uploaded_file",
                "public_url",
                "pipeline_step"
              ]
            },
            "generation_result_id": {
              "minimum": 1,
              "type": "integer"
            },
            "uploaded_file_id": {
              "minimum": 1,
              "type": "integer"
            },
            "image_url": {
              "minLength": 1,
              "type": "string"
            },
            "post_claim_reference": {
              "minLength": 1,
              "type": "string"
            },
            "step_index": {
              "minimum": 0,
              "type": "integer"
            },
            "output_index": {
              "minimum": 0,
              "type": "integer"
            }
          }
        }
      },
      "required": [
        "schema_version",
        "input"
      ],
      "type": "object"
    },
    "GenerationIntent": {
      "additionalProperties": false,
      "description": "Caller-owned model-generation intent shared by every public adapter.\n\nAuthentication-derived identity deliberately does not belong here. REST,\nAgent, MCP, batch, and integrations all submit this exact contract; the\ncommand planner combines it with server-owned execution context later.",
      "properties": {
        "clothing_item_ids": {
          "default": null,
          "items": {
            "type": "integer"
          },
          "type": "array"
        },
        "outfit_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "num_images": {
          "minimum": 1,
          "type": "integer"
        },
        "prompt": {
          "default": "",
          "description": "Scene brief for this shot: setting, lighting, mood, camera/framing, pose — 2-5 compact positive sentences. Without art_direction_id this prompt reaches the image model as-is and is the entire creative direction: carry the shoot's world, lighting, and atmosphere here. With art_direction_id, the saved direction carries reusable style; add only per-shot intent. Supplied garment/avatar/reference images carry product appearance: refer to them semantically ('the supplied jacket'), never by image number — the backend appends the numbered reference map at dispatch. Styling intent (fit, tuck, drape, opening state) belongs here when it matters; re-described garment construction, product-fidelity warnings, and negative 'do not ...' blocks do not — with good references they degrade output. Say what to show, not what to avoid. Video commands: describe motion and camera movement. May be empty for upscale; generation routes validate separately.",
          "type": "string"
        },
        "camera": {
          "default": "",
          "type": "string"
        },
        "camera_edit_id": {
          "default": null,
          "type": "string"
        },
        "avatar_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "art_direction_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "location_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "generation_result_parent_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "enhance_user_prompt": {
          "default": null,
          "deprecated": true,
          "description": "Deprecated REST compatibility alias. true is normalized at command preparation to the legacy prompt-enhancement ArtDirection ID; false has no effect. Prefer art_direction_id. Removal requires 90 consecutive days without production use; usage was last observed on 2026-07-26.",
          "ui": {
            "editable": false,
            "visibility": [
              "rest"
            ]
          },
          "type": "boolean"
        },
        "image_url": {
          "default": null,
          "type": "string"
        },
        "tag_ids": {
          "default": null,
          "items": {
            "type": "integer"
          },
          "type": "array"
        },
        "children": {
          "default": null,
          "description": "Nested generation requests to run after this generation completes. Every child must provide model_slug.",
          "items": {
            "$ref": "#/$defs/GenerationIntent"
          },
          "type": "array"
        },
        "model_slug": {
          "description": "Active AI model slug. Required for every generation command.",
          "minLength": 1,
          "type": "string"
        },
        "use_case": {
          "default": null,
          "type": "string"
        },
        "webhook_url": {
          "default": null,
          "type": "string"
        },
        "webhook_secret": {
          "default": null,
          "description": "Optional HMAC signing secret for customer callbacks.",
          "ui": {
            "sensitive": true
          },
          "type": "string"
        },
        "webhook_events": {
          "default": null,
          "items": {
            "enum": [
              "generation.completed",
              "generation.failed"
            ],
            "type": "string"
          },
          "type": "array"
        },
        "do_qa": {
          "default": null,
          "description": "When true, enqueue QA after result storage and gate acceptance on QA.",
          "type": "boolean"
        },
        "max_qa_retries": {
          "default": null,
          "description": "Maximum QA-triggered retry generations after the initial attempt.",
          "maximum": 5,
          "minimum": 0,
          "type": "integer"
        },
        "resolution": {
          "default": null,
          "description": "Model-defined output resolution. Legacy image tiers are normalized to 1K, 2K, or 4K; video and exact pixel presets retain their model-defined casing.",
          "maxLength": 32,
          "minLength": 2,
          "type": "string"
        },
        "aspect_ratio": {
          "default": null,
          "type": "string"
        },
        "alignment": {
          "default": null,
          "enum": [
            "left",
            "center",
            "right",
            "top",
            "bottom"
          ],
          "type": "string"
        },
        "img_ref_urls": {
          "default": null,
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "reference_attachments": {
          "default": null,
          "items": {
            "$ref": "#/$defs/GenerationReferenceAttachmentInput"
          },
          "type": "array"
        },
        "duration": {
          "default": null,
          "type": "integer"
        },
        "generate_audio": {
          "default": false,
          "type": "boolean"
        },
        "last_frame_url": {
          "default": null,
          "type": "string"
        },
        "upscale_factor": {
          "default": null,
          "type": "number"
        },
        "target_resolution": {
          "default": null,
          "type": "string"
        },
        "seed": {
          "default": null,
          "type": "integer"
        },
        "negative_prompt": {
          "default": null,
          "type": "string"
        },
        "backdrop_mode": {
          "default": null,
          "description": "Canonical Backdrop mode for new generation requests.",
          "enum": [
            "transparent",
            "solid",
            "image"
          ],
          "type": "string"
        },
        "color_hex": {
          "default": null,
          "description": "Canonical Backdrop solid or fallback color.",
          "type": "string"
        },
        "background_image_url": {
          "default": null,
          "description": "Canonical Backdrop background image URL.",
          "type": "string"
        },
        "extra_params": {
          "default": null,
          "description": "Model-specific extension parameters. Backdrop controls are not accepted here; use backdrop_mode, color_hex, and background_image_url.",
          "additionalProperties": true,
          "type": "object"
        }
      },
      "required": [
        "num_images",
        "model_slug"
      ],
      "type": "object"
    },
    "GenerationReferenceAttachmentInput": {
      "properties": {
        "type": {
          "enum": [
            "uploaded_file",
            "generation_result",
            "location",
            "avatar",
            "clothing_item"
          ],
          "type": "string"
        },
        "uploaded_file_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "generation_result_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "location_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "avatar_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "clothing_item_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "clothing_item_asset_id": {
          "default": null,
          "description": "Exact durable clothing asset reference. Provide with clothing_item_id; preferred over the deprecated side selector for repeated detail assets.",
          "minimum": 1,
          "type": "integer"
        },
        "side": {
          "default": null,
          "enum": [
            "front",
            "back"
          ],
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    },
    "GenerationResultCommandSource": {
      "properties": {
        "type": {
          "const": "generation_result",
          "type": "string"
        },
        "generation_result_id": {
          "minimum": 1,
          "type": "integer"
        }
      },
      "required": [
        "type",
        "generation_result_id"
      ],
      "type": "object"
    },
    "PipelineStepCommandSource": {
      "description": "Durable identity for a source produced by an earlier pipeline step.",
      "properties": {
        "type": {
          "const": "pipeline_step",
          "type": "string"
        },
        "post_claim_reference": {
          "minLength": 1,
          "type": "string"
        },
        "step_index": {
          "minimum": 0,
          "type": "integer"
        },
        "output_index": {
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "type",
        "post_claim_reference",
        "step_index",
        "output_index"
      ],
      "type": "object"
    },
    "PublicUrlCommandSource": {
      "properties": {
        "type": {
          "const": "public_url",
          "type": "string"
        },
        "image_url": {
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "type",
        "image_url"
      ],
      "type": "object"
    },
    "UploadedFileCommandSource": {
      "properties": {
        "type": {
          "const": "uploaded_file",
          "type": "string"
        },
        "uploaded_file_id": {
          "minimum": 1,
          "type": "integer"
        }
      },
      "required": [
        "type",
        "uploaded_file_id"
      ],
      "type": "object"
    }
  },
  "description": "Input schema for updating a visible brief without immediate execution."
}

confirm_brief

Call this to approve and idempotently execute a visible persisted Uwear brief. In MCP, a one-word 'Confirm' or phrases like 'looks good', 'run it', 'start', or 'generate' mean execute=true unless the user explicitly says to approve without starting. Use the visible/latest BriefProposal brief_id. Repeated calls return or resume the same durable execution.

Parameters2

brief_id	integer	required	ID of the persisted brief to confirm
execute	boolean	optional	Execute the brief immediately after confirming. Defaults true because MCP 'confirm the brief' means approve and run. Set false only when the user explicitly wants to save approval without starting generation.

Raw schema

{
  "type": "object",
  "properties": {
    "brief_id": {
      "description": "ID of the persisted brief to confirm",
      "exclusiveMinimum": 0,
      "type": "integer"
    },
    "execute": {
      "default": true,
      "description": "Execute the brief immediately after confirming. Defaults true because MCP 'confirm the brief' means approve and run. Set false only when the user explicitly wants to save approval without starting generation.",
      "type": "boolean"
    }
  },
  "required": [
    "brief_id"
  ],
  "description": "Confirm and optionally execute an immutable canonical-command brief."
}

get_brief

Load an existing persisted brief unchanged by a real positive brief_id. Only use when the user supplied that brief_id or after propose_brief/update_brief returned it and the user wants to re-open the same brief. Never use brief_id=0, a placeholder, or a guessed ID. Never use this to start a new photoshoot. When the user asks to modify, rewrite, add steps to, or show an adjusted brief, call update_brief with the complete updated brief instead of looping on get_brief.

Parameters1

brief_id

integer

required

Real persisted brief ID to load unchanged. Do not use 0, guessed IDs, or this tool for editing a visible brief.

Raw schema

{
  "type": "object",
  "properties": {
    "brief_id": {
      "description": "Real persisted brief ID to load unchanged. Do not use 0, guessed IDs, or this tool for editing a visible brief.",
      "exclusiveMinimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "brief_id"
  ],
  "description": "Input schema for loading a persisted brief for UI rehydration."
}

list_models

List available AI generation models (image, video, edit, upscale engines) by type, with credit costs. These are the AI models that render photoshoots — not the human models/avatars; for those, use list_avatars.

Parameters1

model_type

string

required

Type: generation, edit, upscale, video, backdrop

Raw schema

{
  "type": "object",
  "properties": {
    "model_type": {
      "description": "Type: generation, edit, upscale, video, backdrop",
      "type": "string"
    }
  },
  "required": [
    "model_type"
  ],
  "description": "Input schema for listing available models by type."
}

list_art_directions

List selectable ArtDirections as compact summaries: visible system ArtDirections plus company ArtDirections. Use query to match exact names and natural-language creative requests. Use this as the catalog step before choosing an art_direction_id for a brief; if there is no clear match, fall back to the user's phrase as prompt/creative_context. Use get_art_direction for the full markdown document before reusing one in a brief.

Parameters3

query	string	optional	Hybrid search across saved ArtDirection names and creative content.
page	integer	optional	Page number for pagination
limit	integer	optional	Number of compact ArtDirection summaries per page

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "default": null,
      "description": "Hybrid search across saved ArtDirection names and creative content.",
      "minLength": 2,
      "type": "string"
    },
    "page": {
      "default": 1,
      "description": "Page number for pagination",
      "minimum": 1,
      "type": "integer"
    },
    "limit": {
      "default": 20,
      "description": "Number of compact ArtDirection summaries per page",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    }
  },
  "additionalProperties": false,
  "description": "Input schema for listing available ArtDirections."
}

get_art_direction

Get a selectable ArtDirection by ID.

Parameters1

art_direction_id

integer

required

The ArtDirection ID to retrieve

Raw schema

{
  "type": "object",
  "properties": {
    "art_direction_id": {
      "description": "The ArtDirection ID to retrieve",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "art_direction_id"
  ],
  "description": "Input schema for getting an ArtDirection."
}

create_art_direction

Create a company ArtDirection markdown document. Use author_art_direction first when the user provides rough creative text or reference images. Use this direct writer only for already-structured markdown that follows the Variation Controls parser contract.

Parameters3

name	string	required	Name for the ArtDirection
content_markdown	string	required	Complete ArtDirection markdown document. Prefer author_art_direction for rough briefs. If writing directly, every reusable alternative that should rotate across generations must live under `## Variation Controls` as `###` controls with `A. Option` lines; do not leave selectable worlds, pose families, or shot-role plans only in prose.
reference_image_attachments	array	optional	Authoring reference image attachments to keep with the ArtDirection. These are for iterating the markdown only, not generation-time references.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Name for the ArtDirection",
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "content_markdown": {
      "description": "Complete ArtDirection markdown document. Prefer author_art_direction for rough briefs. If writing directly, every reusable alternative that should rotate across generations must live under `## Variation Controls` as `###` controls with `A. Option` lines; do not leave selectable worlds, pose families, or shot-role plans only in prose.",
      "maxLength": 50000,
      "minLength": 1,
      "type": "string"
    },
    "reference_image_attachments": {
      "description": "Authoring reference image attachments to keep with the ArtDirection. These are for iterating the markdown only, not generation-time references.",
      "items": {
        "$ref": "#/$defs/ArtDirectionReferenceImage"
      },
      "type": "array"
    }
  },
  "required": [
    "name",
    "content_markdown"
  ],
  "$defs": {
    "ArtDirectionReferenceImage": {
      "description": "Authoring-only visual reference attached to an ArtDirection.\n\nThese references help regenerate or iterate the markdown document; they are\nnot passed to fashion generation requests just because the ArtDirection is\nselected.",
      "properties": {
        "source_type": {
          "$ref": "#/$defs/ArtDirectionReferenceImageSourceType",
          "description": "Asset kind used only for ArtDirection authoring context."
        },
        "source_id": {
          "description": "ID of the referenced asset.",
          "minimum": 1,
          "type": "integer"
        }
      },
      "required": [
        "source_type",
        "source_id"
      ],
      "type": "object"
    },
    "ArtDirectionReferenceImageSourceType": {
      "enum": [
        "uploaded_file",
        "generation_result",
        "clothing_item",
        "avatar",
        "location"
      ],
      "type": "string"
    }
  },
  "description": "Input schema for creating a company ArtDirection."
}

update_art_direction

Update a company ArtDirection. System ArtDirections are read-only. When changing markdown directly, preserve the Variation Controls parser contract: reusable alternatives must be under `## Variation Controls`, not only in prose.

Parameters4

art_direction_id	integer	required	The ArtDirection ID to update
name	string	optional	Updated ArtDirection name
content_markdown	string	optional	Updated complete ArtDirection markdown. If editing directly, every reusable alternative that should rotate across generations must live under `## Variation Controls` as `###` controls with `A. Option` lines; do not leave selectable worlds, pose families, or shot-role plans only in prose.
reference_image_attachments	array	optional	Replacement authoring reference image attachments. These are for iterating the markdown only, not generation-time references.

Raw schema

{
  "type": "object",
  "properties": {
    "art_direction_id": {
      "description": "The ArtDirection ID to update",
      "minimum": 1,
      "type": "integer"
    },
    "name": {
      "default": null,
      "description": "Updated ArtDirection name",
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "content_markdown": {
      "default": null,
      "description": "Updated complete ArtDirection markdown. If editing directly, every reusable alternative that should rotate across generations must live under `## Variation Controls` as `###` controls with `A. Option` lines; do not leave selectable worlds, pose families, or shot-role plans only in prose.",
      "maxLength": 50000,
      "minLength": 1,
      "type": "string"
    },
    "reference_image_attachments": {
      "default": null,
      "description": "Replacement authoring reference image attachments. These are for iterating the markdown only, not generation-time references.",
      "items": {
        "$ref": "#/$defs/ArtDirectionReferenceImage"
      },
      "type": "array"
    }
  },
  "required": [
    "art_direction_id"
  ],
  "$defs": {
    "ArtDirectionReferenceImage": {
      "description": "Authoring-only visual reference attached to an ArtDirection.\n\nThese references help regenerate or iterate the markdown document; they are\nnot passed to fashion generation requests just because the ArtDirection is\nselected.",
      "properties": {
        "source_type": {
          "$ref": "#/$defs/ArtDirectionReferenceImageSourceType",
          "description": "Asset kind used only for ArtDirection authoring context."
        },
        "source_id": {
          "description": "ID of the referenced asset.",
          "minimum": 1,
          "type": "integer"
        }
      },
      "required": [
        "source_type",
        "source_id"
      ],
      "type": "object"
    },
    "ArtDirectionReferenceImageSourceType": {
      "enum": [
        "uploaded_file",
        "generation_result",
        "clothing_item",
        "avatar",
        "location"
      ],
      "type": "string"
    }
  },
  "description": "Input schema for updating a company ArtDirection."
}

duplicate_art_direction

Duplicate a system or company ArtDirection into an editable company copy.

Parameters2

art_direction_id	integer	required	The ArtDirection ID to duplicate
name	string	optional	Optional name for the copy

Raw schema

{
  "type": "object",
  "properties": {
    "art_direction_id": {
      "description": "The ArtDirection ID to duplicate",
      "minimum": 1,
      "type": "integer"
    },
    "name": {
      "default": null,
      "description": "Optional name for the copy",
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "art_direction_id"
  ],
  "description": "Input schema for duplicating a system or company ArtDirection."
}

author_art_direction

Queue the conversation for asynchronous ArtDirection authoring using Uwear's prompt system. Use save=true when the user wants to create, build, or save a reusable ArtDirection. Use save=false when the user explicitly wants an unsaved draft or brainstorming pass. This returns a job ID; call get_art_direction_authoring_job until status is done or failed.

Parameters5

user_text	string	optional	Conversation text to compile into ArtDirection markdown
image_urls	array	optional	Draft-only reference image URLs to analyze into the ArtDirection. For saved ArtDirections, first save/select assets and pass reference_image_attachments.
reference_image_attachments	array	optional	Persistent authoring references as asset IDs. Use for save=true so the user can iterate the ArtDirection later. These are not generation-time references.
name	string	optional	Optional requested ArtDirection name
save	boolean	optional	Set true when the user wants to create, build, or save a reusable ArtDirection. Set false when the user explicitly wants an unsaved draft or brainstorming pass.

Raw schema

{
  "type": "object",
  "properties": {
    "user_text": {
      "default": "",
      "description": "Conversation text to compile into ArtDirection markdown",
      "type": "string"
    },
    "image_urls": {
      "description": "Draft-only reference image URLs to analyze into the ArtDirection. For saved ArtDirections, first save/select assets and pass reference_image_attachments.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "reference_image_attachments": {
      "description": "Persistent authoring references as asset IDs. Use for save=true so the user can iterate the ArtDirection later. These are not generation-time references.",
      "items": {
        "$ref": "#/$defs/ArtDirectionReferenceImage"
      },
      "type": "array"
    },
    "name": {
      "default": null,
      "description": "Optional requested ArtDirection name",
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "save": {
      "default": false,
      "description": "Set true when the user wants to create, build, or save a reusable ArtDirection. Set false when the user explicitly wants an unsaved draft or brainstorming pass.",
      "type": "boolean"
    }
  },
  "$defs": {
    "ArtDirectionReferenceImage": {
      "description": "Authoring-only visual reference attached to an ArtDirection.\n\nThese references help regenerate or iterate the markdown document; they are\nnot passed to fashion generation requests just because the ArtDirection is\nselected.",
      "properties": {
        "source_type": {
          "$ref": "#/$defs/ArtDirectionReferenceImageSourceType",
          "description": "Asset kind used only for ArtDirection authoring context."
        },
        "source_id": {
          "description": "ID of the referenced asset.",
          "minimum": 1,
          "type": "integer"
        }
      },
      "required": [
        "source_type",
        "source_id"
      ],
      "type": "object"
    },
    "ArtDirectionReferenceImageSourceType": {
      "enum": [
        "uploaded_file",
        "generation_result",
        "clothing_item",
        "avatar",
        "location"
      ],
      "type": "string"
    }
  },
  "description": "Input schema for drafting an ArtDirection from text and reference images."
}

get_art_direction_authoring_job

Read an asynchronous ArtDirection authoring job. Poll the job ID returned by author_art_direction until status is done or failed. A done job includes the authored markdown and, when save=true, the saved art_direction_id.

Parameters1

job_id

integer

required

ArtDirection authoring job ID returned by author_art_direction

Raw schema

{
  "type": "object",
  "properties": {
    "job_id": {
      "description": "ArtDirection authoring job ID returned by author_art_direction",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "job_id"
  ],
  "description": "Input schema for reading an asynchronous ArtDirection authoring job."
}

list_templates

List canonical company templates, optionally filtered by kind, scope, or command use case. Templates persist canonical commands but do not execute generations. System templates named `Demo — …` are worked examples of the canonical command language; read one with `get_template` before authoring a first brief or workflow.

Parameters5

template_kind	any	optional	Filter by generation_preset or batch_workflow
catalog_scope	any	optional	Filter by library or owner_only. Owner-only templates are hidden unless explicitly requested.
use_case	string	optional	Filter by a use_case present in any stored command
page	integer	optional	Page number for pagination
items_per_page	integer	optional	Number of templates per page

Raw schema

{
  "type": "object",
  "properties": {
    "template_kind": {
      "default": null,
      "description": "Filter by generation_preset or batch_workflow",
      "$ref": "#/$defs/TemplateKind"
    },
    "catalog_scope": {
      "default": null,
      "description": "Filter by library or owner_only. Owner-only templates are hidden unless explicitly requested.",
      "$ref": "#/$defs/CatalogScope"
    },
    "use_case": {
      "default": null,
      "description": "Filter by a use_case present in any stored command",
      "minLength": 1,
      "type": "string"
    },
    "page": {
      "default": 1,
      "description": "Page number for pagination",
      "minimum": 1,
      "type": "integer"
    },
    "items_per_page": {
      "default": 50,
      "description": "Number of templates per page",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    }
  },
  "$defs": {
    "CatalogScope": {
      "enum": [
        "library",
        "owner_only"
      ],
      "type": "string"
    },
    "TemplateKind": {
      "enum": [
        "generation_preset",
        "batch_workflow"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false,
  "description": "Input schema for listing company templates."
}

get_template

Load one canonical company template by ID. Pass expected_template_kind when the caller requires a generation_preset or batch_workflow.

Parameters2

template_id	integer	required	Template ID
expected_template_kind	any	optional	Optional expected kind. A mismatch returns both expected and actual kinds.

Raw schema

{
  "type": "object",
  "properties": {
    "template_id": {
      "description": "Template ID",
      "minimum": 1,
      "type": "integer"
    },
    "expected_template_kind": {
      "default": null,
      "description": "Optional expected kind. A mismatch returns both expected and actual kinds.",
      "$ref": "#/$defs/TemplateKind"
    }
  },
  "required": [
    "template_id"
  ],
  "$defs": {
    "TemplateKind": {
      "enum": [
        "generation_preset",
        "batch_workflow"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false,
  "description": "Input schema for loading one company template."
}

save_template

Create a canonical company template, or replace one by passing template_id with expected_revision. Send typed GenerationCommand objects; updates are complete replacements. This persists the template and does not generate images. If a generation_preset create fails structurally, or legacy keys appear (camera_quantities, step2_operations, operations, fixed_context, variable_context, input_policy, cameraQuantities, step2Operations, fixedContext, variableContext, inputPolicy, or their camelCase forms), these describe a batch workflow — use `template_kind=batch_workflow`. front + back is one batch workflow: Step 1 front generation, Step 2 back camera edit.

Parameters7

name	string	required	Template name
description	string	optional	Optional sentence explaining when to use the template
template_kind	any	required	Template kind: generation_preset or batch_workflow
catalog_scope	any	optional	Template catalog scope: library or owner_only
payload	any	required	Versioned template payload containing canonical generation commands
template_id	integer	optional	Template ID when replacing an existing template
expected_revision	integer	optional	Current revision when replacing an existing template; omit for create

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Template name",
      "maxLength": 200,
      "minLength": 1,
      "type": "string"
    },
    "description": {
      "default": null,
      "description": "Optional sentence explaining when to use the template",
      "type": "string"
    },
    "template_kind": {
      "$ref": "#/$defs/TemplateKind",
      "description": "Template kind: generation_preset or batch_workflow"
    },
    "catalog_scope": {
      "$ref": "#/$defs/CatalogScope",
      "default": "library",
      "description": "Template catalog scope: library or owner_only"
    },
    "payload": {
      "$ref": "#/$defs/TemplatePayload",
      "description": "Versioned template payload containing canonical generation commands"
    },
    "template_id": {
      "default": null,
      "description": "Template ID when replacing an existing template",
      "minimum": 1,
      "type": "integer"
    },
    "expected_revision": {
      "default": null,
      "description": "Current revision when replacing an existing template; omit for create",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "name",
    "template_kind",
    "payload"
  ],
  "$defs": {
    "CatalogScope": {
      "enum": [
        "library",
        "owner_only"
      ],
      "type": "string"
    },
    "GenerationCommand": {
      "additionalProperties": false,
      "description": "Versioned command shared by REST, Agent, MCP, jobs, and briefs.\n\nThe nested ``input`` is intentionally the API's public intent model. A\nfield added there therefore appears automatically in this command's JSON\nschema, serialization, and persisted brief representation.",
      "properties": {
        "schema_version": {
          "const": 2,
          "type": "integer"
        },
        "input": {
          "$ref": "#/$defs/GenerationIntent"
        },
        "source": {
          "default": null,
          "discriminator": {
            "mapping": {
              "generation_result": "#/$defs/GenerationResultCommandSource",
              "pipeline_step": "#/$defs/PipelineStepCommandSource",
              "public_url": "#/$defs/PublicUrlCommandSource",
              "uploaded_file": "#/$defs/UploadedFileCommandSource"
            },
            "propertyName": "type"
          },
          "oneOf": [
            {
              "properties": {
                "type": {
                  "const": "generation_result",
                  "type": "string"
                },
                "generation_result_id": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "required": [
                "type",
                "generation_result_id"
              ],
              "type": "object"
            },
            {
              "properties": {
                "type": {
                  "const": "uploaded_file",
                  "type": "string"
                },
                "uploaded_file_id": {
                  "minimum": 1,
                  "type": "integer"
                }
              },
              "required": [
                "type",
                "uploaded_file_id"
              ],
              "type": "object"
            },
            {
              "properties": {
                "type": {
                  "const": "public_url",
                  "type": "string"
                },
                "image_url": {
                  "minLength": 1,
                  "type": "string"
                }
              },
              "required": [
                "type",
                "image_url"
              ],
              "type": "object"
            },
            {
              "description": "Durable identity for a source produced by an earlier pipeline step.",
              "properties": {
                "type": {
                  "const": "pipeline_step",
                  "type": "string"
                },
                "post_claim_reference": {
                  "minLength": 1,
                  "type": "string"
                },
                "step_index": {
                  "minimum": 0,
                  "type": "integer"
                },
                "output_index": {
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "required": [
                "type",
                "post_claim_reference",
                "step_index",
                "output_index"
              ],
              "type": "object"
            }
          ],
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "enum": [
                "generation_result",
                "uploaded_file",
                "public_url",
                "pipeline_step"
              ]
            },
            "generation_result_id": {
              "minimum": 1,
              "type": "integer"
            },
            "uploaded_file_id": {
              "minimum": 1,
              "type": "integer"
            },
            "image_url": {
              "minLength": 1,
              "type": "string"
            },
            "post_claim_reference": {
              "minLength": 1,
              "type": "string"
            },
            "step_index": {
              "minimum": 0,
              "type": "integer"
            },
            "output_index": {
              "minimum": 0,
              "type": "integer"
            }
          }
        }
      },
      "required": [
        "schema_version",
        "input"
      ],
      "type": "object"
    },
    "GenerationIntent": {
      "additionalProperties": false,
      "description": "Caller-owned model-generation intent shared by every public adapter.\n\nAuthentication-derived identity deliberately does not belong here. REST,\nAgent, MCP, batch, and integrations all submit this exact contract; the\ncommand planner combines it with server-owned execution context later.",
      "properties": {
        "clothing_item_ids": {
          "default": null,
          "items": {
            "type": "integer"
          },
          "type": "array"
        },
        "outfit_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "num_images": {
          "minimum": 1,
          "type": "integer"
        },
        "prompt": {
          "default": "",
          "description": "Scene brief for this shot: setting, lighting, mood, camera/framing, pose — 2-5 compact positive sentences. Without art_direction_id this prompt reaches the image model as-is and is the entire creative direction: carry the shoot's world, lighting, and atmosphere here. With art_direction_id, the saved direction carries reusable style; add only per-shot intent. Supplied garment/avatar/reference images carry product appearance: refer to them semantically ('the supplied jacket'), never by image number — the backend appends the numbered reference map at dispatch. Styling intent (fit, tuck, drape, opening state) belongs here when it matters; re-described garment construction, product-fidelity warnings, and negative 'do not ...' blocks do not — with good references they degrade output. Say what to show, not what to avoid. Video commands: describe motion and camera movement. May be empty for upscale; generation routes validate separately.",
          "type": "string"
        },
        "camera": {
          "default": "",
          "type": "string"
        },
        "camera_edit_id": {
          "default": null,
          "type": "string"
        },
        "avatar_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "art_direction_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "location_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "generation_result_parent_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "enhance_user_prompt": {
          "default": null,
          "deprecated": true,
          "description": "Deprecated REST compatibility alias. true is normalized at command preparation to the legacy prompt-enhancement ArtDirection ID; false has no effect. Prefer art_direction_id. Removal requires 90 consecutive days without production use; usage was last observed on 2026-07-26.",
          "ui": {
            "editable": false,
            "visibility": [
              "rest"
            ]
          },
          "type": "boolean"
        },
        "image_url": {
          "default": null,
          "type": "string"
        },
        "tag_ids": {
          "default": null,
          "items": {
            "type": "integer"
          },
          "type": "array"
        },
        "children": {
          "default": null,
          "description": "Nested generation requests to run after this generation completes. Every child must provide model_slug.",
          "items": {
            "$ref": "#/$defs/GenerationIntent"
          },
          "type": "array"
        },
        "model_slug": {
          "description": "Active AI model slug. Required for every generation command.",
          "minLength": 1,
          "type": "string"
        },
        "use_case": {
          "default": null,
          "type": "string"
        },
        "webhook_url": {
          "default": null,
          "type": "string"
        },
        "webhook_secret": {
          "default": null,
          "description": "Optional HMAC signing secret for customer callbacks.",
          "ui": {
            "sensitive": true
          },
          "type": "string"
        },
        "webhook_events": {
          "default": null,
          "items": {
            "enum": [
              "generation.completed",
              "generation.failed"
            ],
            "type": "string"
          },
          "type": "array"
        },
        "do_qa": {
          "default": null,
          "description": "When true, enqueue QA after result storage and gate acceptance on QA.",
          "type": "boolean"
        },
        "max_qa_retries": {
          "default": null,
          "description": "Maximum QA-triggered retry generations after the initial attempt.",
          "maximum": 5,
          "minimum": 0,
          "type": "integer"
        },
        "resolution": {
          "default": null,
          "description": "Model-defined output resolution. Legacy image tiers are normalized to 1K, 2K, or 4K; video and exact pixel presets retain their model-defined casing.",
          "maxLength": 32,
          "minLength": 2,
          "type": "string"
        },
        "aspect_ratio": {
          "default": null,
          "type": "string"
        },
        "alignment": {
          "default": null,
          "enum": [
            "left",
            "center",
            "right",
            "top",
            "bottom"
          ],
          "type": "string"
        },
        "img_ref_urls": {
          "default": null,
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "reference_attachments": {
          "default": null,
          "items": {
            "$ref": "#/$defs/GenerationReferenceAttachmentInput"
          },
          "type": "array"
        },
        "duration": {
          "default": null,
          "type": "integer"
        },
        "generate_audio": {
          "default": false,
          "type": "boolean"
        },
        "last_frame_url": {
          "default": null,
          "type": "string"
        },
        "upscale_factor": {
          "default": null,
          "type": "number"
        },
        "target_resolution": {
          "default": null,
          "type": "string"
        },
        "seed": {
          "default": null,
          "type": "integer"
        },
        "negative_prompt": {
          "default": null,
          "type": "string"
        },
        "backdrop_mode": {
          "default": null,
          "description": "Canonical Backdrop mode for new generation requests.",
          "enum": [
            "transparent",
            "solid",
            "image"
          ],
          "type": "string"
        },
        "color_hex": {
          "default": null,
          "description": "Canonical Backdrop solid or fallback color.",
          "type": "string"
        },
        "background_image_url": {
          "default": null,
          "description": "Canonical Backdrop background image URL.",
          "type": "string"
        },
        "extra_params": {
          "default": null,
          "description": "Model-specific extension parameters. Backdrop controls are not accepted here; use backdrop_mode, color_hex, and background_image_url.",
          "additionalProperties": true,
          "type": "object"
        }
      },
      "required": [
        "num_images",
        "model_slug"
      ],
      "type": "object"
    },
    "GenerationReferenceAttachmentInput": {
      "properties": {
        "type": {
          "enum": [
            "uploaded_file",
            "generation_result",
            "location",
            "avatar",
            "clothing_item"
          ],
          "type": "string"
        },
        "uploaded_file_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "generation_result_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "location_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "avatar_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "clothing_item_id": {
          "default": null,
          "minimum": 1,
          "type": "integer"
        },
        "clothing_item_asset_id": {
          "default": null,
          "description": "Exact durable clothing asset reference. Provide with clothing_item_id; preferred over the deprecated side selector for repeated detail assets.",
          "minimum": 1,
          "type": "integer"
        },
        "side": {
          "default": null,
          "enum": [
            "front",
            "back"
          ],
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    },
    "GenerationResultCommandSource": {
      "properties": {
        "type": {
          "const": "generation_result",
          "type": "string"
        },
        "generation_result_id": {
          "minimum": 1,
          "type": "integer"
        }
      },
      "required": [
        "type",
        "generation_result_id"
      ],
      "type": "object"
    },
    "PipelineStepCommandSource": {
      "description": "Durable identity for a source produced by an earlier pipeline step.",
      "properties": {
        "type": {
          "const": "pipeline_step",
          "type": "string"
        },
        "post_claim_reference": {
          "minLength": 1,
          "type": "string"
        },
        "step_index": {
          "minimum": 0,
          "type": "integer"
        },
        "output_index": {
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "type",
        "post_claim_reference",
        "step_index",
        "output_index"
      ],
      "type": "object"
    },
    "PublicUrlCommandSource": {
      "properties": {
        "type": {
          "const": "public_url",
          "type": "string"
        },
        "image_url": {
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "type",
        "image_url"
      ],
      "type": "object"
    },
    "TemplateKind": {
      "enum": [
        "generation_preset",
        "batch_workflow"
      ],
      "type": "string"
    },
    "TemplatePayload": {
      "additionalProperties": false,
      "properties": {
        "payload_schema_version": {
          "const": 1,
          "type": "integer"
        },
        "commands": {
          "items": {
            "$ref": "#/$defs/GenerationCommand"
          },
          "minItems": 1,
          "type": "array"
        },
        "pairing_policy": {
          "default": null,
          "const": "one_workflow_per_row",
          "type": "string"
        }
      },
      "required": [
        "payload_schema_version",
        "commands"
      ],
      "type": "object"
    },
    "UploadedFileCommandSource": {
      "properties": {
        "type": {
          "const": "uploaded_file",
          "type": "string"
        },
        "uploaded_file_id": {
          "minimum": 1,
          "type": "integer"
        }
      },
      "required": [
        "type",
        "uploaded_file_id"
      ],
      "type": "object"
    }
  },
  "additionalProperties": false,
  "description": "Create a template or fully replace one at an expected revision."
}

delete_template

Permanently delete a library template. Owner-only templates must be deleted through their owning resource.

Parameters1

template_id

integer

required

Template ID

Raw schema

{
  "type": "object",
  "properties": {
    "template_id": {
      "description": "Template ID",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "template_id"
  ],
  "additionalProperties": false,
  "description": "Input schema for deleting one company template."
}

prepare_local_garment_upload

First step for garment images on the host's local filesystem, such as files in ~/Downloads. Use only when the host can read those local files and perform the returned direct multipart HTTP uploads, such as Codex. Include every returned form field and send the file bytes under the returned file_field. Never send a local path to Uwear. Do not use this for ChatGPT attachments or existing public URLs. After every upload succeeds, call finish_local_garment_upload with the returned upload handles.

Parameters1

files

array

required

Local image metadata in a stable order. The local paths never leave the client.

Raw schema

{
  "type": "object",
  "properties": {
    "files": {
      "description": "Local image metadata in a stable order. The local paths never leave the client.",
      "items": {
        "additionalProperties": false,
        "description": "Metadata for one client-local image that will be uploaded directly.",
        "properties": {
          "file_name": {
            "description": "Local image filename only; never include its filesystem path",
            "maxLength": 255,
            "minLength": 1,
            "type": "string"
          },
          "content_type": {
            "description": "Image MIME type used by the direct upload",
            "enum": [
              "image/jpeg",
              "image/png",
              "image/webp",
              "image/avif",
              "image/gif",
              "image/bmp",
              "image/tiff"
            ],
            "type": "string"
          },
          "content_length": {
            "description": "Exact local image size in bytes; maximum 25 MB",
            "exclusiveMinimum": 0,
            "maximum": 26214400,
            "type": "integer"
          }
        },
        "required": [
          "file_name",
          "content_type",
          "content_length"
        ],
        "type": "object"
      },
      "maxItems": 20,
      "minItems": 1,
      "type": "array"
    }
  },
  "required": [
    "files"
  ],
  "$defs": {
    "LocalGarmentUploadFileInput": {
      "additionalProperties": false,
      "description": "Metadata for one client-local image that will be uploaded directly.",
      "properties": {
        "file_name": {
          "description": "Local image filename only; never include its filesystem path",
          "maxLength": 255,
          "minLength": 1,
          "type": "string"
        },
        "content_type": {
          "description": "Image MIME type used by the direct upload",
          "enum": [
            "image/jpeg",
            "image/png",
            "image/webp",
            "image/avif",
            "image/gif",
            "image/bmp",
            "image/tiff"
          ],
          "type": "string"
        },
        "content_length": {
          "description": "Exact local image size in bytes; maximum 25 MB",
          "exclusiveMinimum": 0,
          "maximum": 26214400,
          "type": "integer"
        }
      },
      "required": [
        "file_name",
        "content_type",
        "content_length"
      ],
      "type": "object"
    }
  },
  "additionalProperties": false,
  "description": "Create direct-upload targets for client-local garment images."
}

finish_local_garment_upload

Second step only for local garment images already prepared with prepare_local_garment_upload and uploaded to every returned target. Classify each upload_handle as a full/detail front/back/side asset. Do not use this for ChatGPT attachments or arbitrary public URLs.

Parameters1

garments

array

required

Garments assembled from owned upload handles returned by prepare_local_garment_upload

Raw schema

{
  "type": "object",
  "properties": {
    "garments": {
      "description": "Garments assembled from owned upload handles returned by prepare_local_garment_upload",
      "items": {
        "additionalProperties": false,
        "description": "One garment assembled from directly uploaded local assets.",
        "properties": {
          "name": {
            "default": null,
            "description": "Name for the garment. If omitted, derived from the front image filename.",
            "type": "string"
          },
          "description": {
            "default": null,
            "description": "Optional item-level garment description hint",
            "type": "string"
          },
          "gender": {
            "default": null,
            "description": "Target gender: male, female, unisex",
            "type": "string"
          },
          "processing_mode": {
            "default": null,
            "description": "Optional image processing. 'background_removal' removes the background (the platform upload default); 'none' stores the image as-is. Omit to use background removal.",
            "type": "string"
          },
          "assets": {
            "description": "Uploaded garment assets. Exactly one full front is required; full front/back/side views are unique and detail views can repeat.",
            "items": {
              "additionalProperties": false,
              "description": "One classified garment asset previously prepared and uploaded directly.",
              "properties": {
                "asset_kind": {
                  "default": null,
                  "description": "Asset kind: full garment view or detail crop.",
                  "enum": [
                    "full",
                    "detail"
                  ],
                  "type": "string"
                },
                "asset_view": {
                  "default": null,
                  "description": "Visible garment view. New detail uploads require front, back, or side.",
                  "enum": [
                    "front",
                    "back",
                    "side",
                    "unspecified"
                  ],
                  "type": "string"
                },
                "asset_role": {
                  "default": null,
                  "deprecated": true,
                  "description": "Deprecated role-only adapter. Prefer asset_kind and asset_view.",
                  "enum": [
                    "front",
                    "back",
                    "side",
                    "detail"
                  ],
                  "type": "string"
                },
                "upload_handle": {
                  "description": "Owned upload handle returned by prepare_local_garment_upload",
                  "minLength": 1,
                  "type": "string"
                }
              },
              "required": [
                "upload_handle"
              ],
              "type": "object"
            },
            "minItems": 1,
            "type": "array"
          }
        },
        "required": [
          "assets"
        ],
        "type": "object"
      },
      "maxItems": 10,
      "minItems": 1,
      "type": "array"
    }
  },
  "required": [
    "garments"
  ],
  "$defs": {
    "GarmentLocalUploadAssetInput": {
      "additionalProperties": false,
      "description": "One classified garment asset previously prepared and uploaded directly.",
      "properties": {
        "asset_kind": {
          "default": null,
          "description": "Asset kind: full garment view or detail crop.",
          "enum": [
            "full",
            "detail"
          ],
          "type": "string"
        },
        "asset_view": {
          "default": null,
          "description": "Visible garment view. New detail uploads require front, back, or side.",
          "enum": [
            "front",
            "back",
            "side",
            "unspecified"
          ],
          "type": "string"
        },
        "asset_role": {
          "default": null,
          "deprecated": true,
          "description": "Deprecated role-only adapter. Prefer asset_kind and asset_view.",
          "enum": [
            "front",
            "back",
            "side",
            "detail"
          ],
          "type": "string"
        },
        "upload_handle": {
          "description": "Owned upload handle returned by prepare_local_garment_upload",
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "upload_handle"
      ],
      "type": "object"
    },
    "GarmentLocalUploadItem": {
      "additionalProperties": false,
      "description": "One garment assembled from directly uploaded local assets.",
      "properties": {
        "name": {
          "default": null,
          "description": "Name for the garment. If omitted, derived from the front image filename.",
          "type": "string"
        },
        "description": {
          "default": null,
          "description": "Optional item-level garment description hint",
          "type": "string"
        },
        "gender": {
          "default": null,
          "description": "Target gender: male, female, unisex",
          "type": "string"
        },
        "processing_mode": {
          "default": null,
          "description": "Optional image processing. 'background_removal' removes the background (the platform upload default); 'none' stores the image as-is. Omit to use background removal.",
          "type": "string"
        },
        "assets": {
          "description": "Uploaded garment assets. Exactly one full front is required; full front/back/side views are unique and detail views can repeat.",
          "items": {
            "additionalProperties": false,
            "description": "One classified garment asset previously prepared and uploaded directly.",
            "properties": {
              "asset_kind": {
                "default": null,
                "description": "Asset kind: full garment view or detail crop.",
                "enum": [
                  "full",
                  "detail"
                ],
                "type": "string"
              },
              "asset_view": {
                "default": null,
                "description": "Visible garment view. New detail uploads require front, back, or side.",
                "enum": [
                  "front",
                  "back",
                  "side",
                  "unspecified"
                ],
                "type": "string"
              },
              "asset_role": {
                "default": null,
                "deprecated": true,
                "description": "Deprecated role-only adapter. Prefer asset_kind and asset_view.",
                "enum": [
                  "front",
                  "back",
                  "side",
                  "detail"
                ],
                "type": "string"
              },
              "upload_handle": {
                "description": "Owned upload handle returned by prepare_local_garment_upload",
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "upload_handle"
            ],
            "type": "object"
          },
          "minItems": 1,
          "type": "array"
        }
      },
      "required": [
        "assets"
      ],
      "type": "object"
    }
  },
  "additionalProperties": false,
  "description": "Finish garments from owned direct-upload handles."
}

mcp_get_context

App-only: hydrate the session-scoped Uwear Shoot Board.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

mcp_replace_context

App-only: replace the session-scoped Uwear Shoot Board items.

Parameters2

context_items	array	optional	Shoot Board items that replace the current list when context_state is omitted
context_state	object	optional	Complete Shoot Board state to sanitize and persist; takes precedence over context_items

Raw schema

{
  "type": "object",
  "properties": {
    "context_items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "type": "integer"
          },
          "key": {
            "type": "string"
          },
          "id": {
            "oneOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ]
          },
          "type": {
            "type": "string",
            "enum": [
              "clothing",
              "models",
              "outfits",
              "generations",
              "files",
              "locations"
            ]
          },
          "name": {
            "type": "string"
          },
          "thumbnailUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "mediaUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "posterUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "isVideo": {
            "type": "boolean"
          },
          "refs": {
            "type": "object"
          }
        },
        "required": [
          "id",
          "type"
        ]
      },
      "description": "Shoot Board items that replace the current list when context_state is omitted"
    },
    "context_state": {
      "type": "object",
      "description": "Complete Shoot Board state to sanitize and persist; takes precedence over context_items",
      "properties": {
        "schemaVersion": {
          "type": "integer"
        },
        "revision": {
          "type": "integer"
        },
        "updatedAt": {
          "type": "string"
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "schemaVersion": {
                "type": "integer"
              },
              "key": {
                "type": "string"
              },
              "id": {
                "oneOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "string"
                  }
                ]
              },
              "type": {
                "type": "string",
                "enum": [
                  "clothing",
                  "models",
                  "outfits",
                  "generations",
                  "files",
                  "locations"
                ]
              },
              "name": {
                "type": "string"
              },
              "thumbnailUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "mediaUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "posterUrl": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "isVideo": {
                "type": "boolean"
              },
              "refs": {
                "type": "object"
              }
            },
            "required": [
              "id",
              "type"
            ]
          }
        },
        "pendingRequest": {
          "type": [
            "object",
            "null"
          ]
        },
        "draftSelectionKeys": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    }
  },
  "required": []
}

mcp_add_context

App-only: append items to the session-scoped Uwear Shoot Board.

Parameters1

context_items

array

required

Shoot Board items to append to the current list

Raw schema

{
  "type": "object",
  "properties": {
    "context_items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "type": "integer"
          },
          "key": {
            "type": "string"
          },
          "id": {
            "oneOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ]
          },
          "type": {
            "type": "string",
            "enum": [
              "clothing",
              "models",
              "outfits",
              "generations",
              "files",
              "locations"
            ]
          },
          "name": {
            "type": "string"
          },
          "thumbnailUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "mediaUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "posterUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "isVideo": {
            "type": "boolean"
          },
          "refs": {
            "type": "object"
          }
        },
        "required": [
          "id",
          "type"
        ]
      },
      "description": "Shoot Board items to append to the current list"
    }
  },
  "required": [
    "context_items"
  ]
}

mcp_clear_context

App-only: clear all session context items, or only one context type.

Parameters1

type

string

optional

Context type to remove; omit to clear the entire Shoot Board

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "clothing",
        "models",
        "outfits",
        "generations",
        "file",
        "files",
        "location",
        "locations"
      ],
      "description": "Context type to remove; omit to clear the entire Shoot Board"
    }
  },
  "required": []
}

mcp_list_files

App-only: list uploaded files for the Uwear MCP workspace files tab.

Parameters2

page	integer	optional	Page number for uploaded file results
limit	integer	optional	Maximum number of uploaded files per page

Raw schema

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "Page number for uploaded file results"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Maximum number of uploaded files per page"
    }
  },
  "required": []
}

mcp_save_retouch

App-only: save a user-edited image from the shared ImageDetail retouch editor as a child generation result. Hidden from host LLMs; the MCP iframe calls this after the user presses Save.

Parameters5

parent_generation_result_id	integer	required	Generation result ID of the original image
image_base64	string	required	Retouched image encoded as base64 or an image data URL
file_name	string \| null	optional	Optional filename for the saved retouched image
mime_type	string \| null	optional	Optional image MIME type; inferred from a data URL or defaults to image/png
operations	any	optional	Optional retouch operation metadata stored with the child result

Raw schema

{
  "type": "object",
  "properties": {
    "parent_generation_result_id": {
      "type": "integer",
      "minimum": 1,
      "description": "Generation result ID of the original image"
    },
    "image_base64": {
      "type": "string",
      "description": "Retouched image encoded as base64 or an image data URL"
    },
    "file_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional filename for the saved retouched image"
    },
    "mime_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional image MIME type; inferred from a data URL or defaults to image/png"
    },
    "operations": {
      "description": "Optional retouch operation metadata stored with the child result"
    }
  },
  "required": [
    "parent_generation_result_id",
    "image_base64"
  ]
}

mcp_export_montage

App-only: export the user-confirmed montage clips as a stitched video. Spends credits, so it is hidden from host LLMs; the MCP iframe calls this after the user presses Export on the MontageProposal card. Returns the generation_id to poll via get_generation_status.

Parameters4

clips	array	required	Ordered generation-result clips to stitch into the montage
aspect_ratio	string	required	Output video aspect ratio in W:H format
base_resolution	integer	required	Output base resolution in pixels
fit_mode	string	required	How each clip fits the output frame: contain or cover

Raw schema

{
  "type": "object",
  "properties": {
    "clips": {
      "type": "array",
      "minItems": 1,
      "description": "Ordered generation-result clips to stitch into the montage",
      "items": {
        "type": "object",
        "properties": {
          "generation_result_id": {
            "type": "integer",
            "minimum": 1
          },
          "order": {
            "type": "integer",
            "minimum": 0
          },
          "in_point": {
            "type": [
              "number",
              "null"
            ]
          },
          "out_point": {
            "type": [
              "number",
              "null"
            ]
          },
          "speed": {
            "type": [
              "number",
              "null"
            ]
          },
          "muted": {
            "type": [
              "boolean",
              "null"
            ]
          }
        },
        "required": [
          "generation_result_id",
          "order"
        ]
      }
    },
    "aspect_ratio": {
      "type": "string",
      "description": "Output video aspect ratio in W:H format"
    },
    "base_resolution": {
      "type": "integer",
      "minimum": 1,
      "description": "Output base resolution in pixels"
    },
    "fit_mode": {
      "type": "string",
      "description": "How each clip fits the output frame: contain or cover"
    }
  },
  "required": [
    "clips",
    "aspect_ratio",
    "base_resolution",
    "fit_mode"
  ]
}

mcp_generate_clip

App-only: queue an image-to-video generation for a montage clip. Spends credits, so it is hidden from host LLMs; the montage editor calls this when the user presses Generate on a draft clip. Returns the generation_id to poll via get_generation_status.

Parameters9

model	string	required	Video model slug or supported model name
prompt	string \| null	optional	Optional motion prompt for the video clip
duration	integer \| null	optional	Video duration in seconds; defaults to 5
resolution	string \| null	optional	Optional output resolution; defaults to 480p
generate_audio	boolean \| null	optional	Whether to generate audio with the video
last_frame_url	string \| null	optional	Optional final-frame image URL for supported video models
generation_result_id	integer \| null	optional	Existing generation result ID to use as the source image; provide exactly one source
uploaded_file_id	integer \| null	optional	Uploaded file ID to use as the source image; provide exactly one source
image_url	string \| null	optional	HTTPS source image URL; provide exactly one source

Raw schema

{
  "type": "object",
  "properties": {
    "model": {
      "type": "string",
      "description": "Video model slug or supported model name"
    },
    "prompt": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional motion prompt for the video clip"
    },
    "duration": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 1,
      "description": "Video duration in seconds; defaults to 5"
    },
    "resolution": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional output resolution; defaults to 480p"
    },
    "generate_audio": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Whether to generate audio with the video"
    },
    "last_frame_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional final-frame image URL for supported video models"
    },
    "generation_result_id": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 1,
      "description": "Existing generation result ID to use as the source image; provide exactly one source"
    },
    "uploaded_file_id": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 1,
      "description": "Uploaded file ID to use as the source image; provide exactly one source"
    },
    "image_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "HTTPS source image URL; provide exactly one source"
    }
  },
  "required": [
    "model"
  ]
}

create_credit_checkout_session

Create a hosted Stripe Checkout URL for buying Uwear generation credits. Use only when the user explicitly asks to buy, add, top up, or purchase credits, or when they ask how to continue after insufficient credits. Do not call during photoshoot planning unless the user requested checkout. The tool only creates a payment link; the user must open and complete payment in Stripe.

Parameters4

credits	integer	optional	Number of Uwear credits to purchase
return_success_url	string \| null	optional	Optional checkout completion URL; defaults to the Uwear frontend
return_cancel_url	string \| null	optional	Optional checkout cancellation URL; defaults to the Uwear credits page
user_agent	string \| null	optional	Optional client user-agent recorded with checkout metadata

Raw schema

{
  "type": "object",
  "properties": {
    "credits": {
      "type": "integer",
      "minimum": 50,
      "maximum": 50000,
      "default": 200,
      "description": "Number of Uwear credits to purchase"
    },
    "return_success_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional checkout completion URL; defaults to the Uwear frontend"
    },
    "return_cancel_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional checkout cancellation URL; defaults to the Uwear credits page"
    },
    "user_agent": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional client user-agent recorded with checkout metadata"
    }
  },
  "required": []
}

mcp_create_credit_checkout_session

App-only: create a hosted Stripe Checkout URL for buying Uwear credits from the MCP workspace credit control. Hidden from the host LLM so photoshoot planning does not drift into billing unless the user presses the plus button.

Parameters4

credits	integer	optional	Number of Uwear credits to purchase
return_success_url	string \| null	optional	Optional checkout completion URL; defaults to the Uwear frontend
return_cancel_url	string \| null	optional	Optional checkout cancellation URL; defaults to the Uwear credits page
user_agent	string \| null	optional	Optional client user-agent recorded with checkout metadata

Raw schema

{
  "type": "object",
  "properties": {
    "credits": {
      "type": "integer",
      "minimum": 50,
      "maximum": 50000,
      "default": 200,
      "description": "Number of Uwear credits to purchase"
    },
    "return_success_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional checkout completion URL; defaults to the Uwear frontend"
    },
    "return_cancel_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional checkout cancellation URL; defaults to the Uwear credits page"
    },
    "user_agent": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional client user-agent recorded with checkout metadata"
    }
  },
  "required": []
}

create_production_workflow

Create a workflow. It has no graph until a version is created, and it runs nothing until a version is published.

Parameters1

workflow

any

required

Workflow name and initial state; enabled must be false until a version is published

Raw schema

{
  "type": "object",
  "properties": {
    "workflow": {
      "$ref": "#/$defs/WorkflowCreate",
      "description": "Workflow name and initial state; enabled must be false until a version is published"
    }
  },
  "required": [
    "workflow"
  ],
  "$defs": {
    "WorkflowCreate": {
      "additionalProperties": false,
      "properties": {
        "name": {
          "maxLength": 200,
          "minLength": 1,
          "title": "Name",
          "type": "string"
        },
        "enabled": {
          "default": false,
          "title": "Enabled",
          "type": "boolean"
        }
      },
      "required": [
        "name"
      ],
      "title": "WorkflowCreate",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "title": "CreateWorkflowInput"
}

list_production_workflows

List this company's workflows.

Parameters3

include_archived	boolean	optional	Include archived workflows in the results
page	integer	optional	Page number for workflow results
items_per_page	integer	optional	Number of workflows per page

Raw schema

{
  "type": "object",
  "properties": {
    "include_archived": {
      "default": false,
      "description": "Include archived workflows in the results",
      "title": "Include Archived",
      "type": "boolean"
    },
    "page": {
      "default": 1,
      "description": "Page number for workflow results",
      "minimum": 1,
      "title": "Page",
      "type": "integer"
    },
    "items_per_page": {
      "default": 50,
      "description": "Number of workflows per page",
      "maximum": 100,
      "minimum": 1,
      "title": "Items Per Page",
      "type": "integer"
    }
  },
  "additionalProperties": false,
  "title": "ListWorkflowsInput"
}

get_production_workflow

Read one workflow with its version summaries and which version is live.

Parameters3

workflow_id	string	required	Workflow ID
versions_page	integer	optional	Page number for the embedded workflow version list
versions_items_per_page	integer	optional	Number of embedded workflow versions per page

Raw schema

{
  "type": "object",
  "properties": {
    "workflow_id": {
      "description": "Workflow ID",
      "format": "uuid",
      "title": "Workflow Id",
      "type": "string"
    },
    "versions_page": {
      "default": 1,
      "description": "Page number for the embedded workflow version list",
      "minimum": 1,
      "title": "Versions Page",
      "type": "integer"
    },
    "versions_items_per_page": {
      "default": 50,
      "description": "Number of embedded workflow versions per page",
      "maximum": 100,
      "minimum": 1,
      "title": "Versions Items Per Page",
      "type": "integer"
    }
  },
  "required": [
    "workflow_id"
  ],
  "additionalProperties": false,
  "title": "GetWorkflowInput"
}

update_production_workflow

Rename a workflow, or enable/disable it. Disabling stops new runs from being admitted; runs already in flight finish.

Parameters2

workflow_id	string	required	Workflow ID
update	any	required	Workflow fields to update: name, enabled, or archived

Raw schema

{
  "type": "object",
  "properties": {
    "workflow_id": {
      "description": "Workflow ID",
      "format": "uuid",
      "title": "Workflow Id",
      "type": "string"
    },
    "update": {
      "$ref": "#/$defs/WorkflowUpdate",
      "description": "Workflow fields to update: name, enabled, or archived"
    }
  },
  "required": [
    "workflow_id",
    "update"
  ],
  "$defs": {
    "WorkflowUpdate": {
      "additionalProperties": false,
      "properties": {
        "name": {
          "default": null,
          "maxLength": 200,
          "minLength": 1,
          "title": "Name",
          "type": "string"
        },
        "enabled": {
          "default": null,
          "title": "Enabled",
          "type": "boolean"
        },
        "archived": {
          "default": null,
          "title": "Archived",
          "type": "boolean"
        }
      },
      "title": "WorkflowUpdate",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "title": "UpdateWorkflowInput"
}

archive_production_workflow

Archive a workflow and disable it. Reversible with update_production_workflow.

Parameters1

workflow_id

string

required

Workflow ID

Raw schema

{
  "type": "object",
  "properties": {
    "workflow_id": {
      "description": "Workflow ID",
      "format": "uuid",
      "title": "Workflow Id",
      "type": "string"
    }
  },
  "required": [
    "workflow_id"
  ],
  "additionalProperties": false,
  "title": "WorkflowIdentityInput"
}

create_production_workflow_version

Open a new draft version holding the graph. Drafts are editable and never execute. See uwear://contracts/production-workflow for typed node configs and worked examples.

Parameters2

workflow_id	string	required	Workflow ID
definition	any	required	Draft workflow graph, contract version, failure policy, and optional published base version

Raw schema

{
  "type": "object",
  "properties": {
    "workflow_id": {
      "description": "Workflow ID",
      "format": "uuid",
      "title": "Workflow Id",
      "type": "string"
    },
    "definition": {
      "$ref": "#/$defs/WorkflowVersionCreate",
      "description": "Draft workflow graph, contract version, failure policy, and optional published base version"
    }
  },
  "required": [
    "workflow_id",
    "definition"
  ],
  "$defs": {
    "AiModelInputConfig": {
      "additionalProperties": false,
      "properties": {
        "model_slug": {
          "anyOf": [
            {
              "maxLength": 100,
              "minLength": 1,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Model Slug"
        }
      },
      "title": "AiModelInputConfig",
      "type": "object"
    },
    "AiModelInputNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "type": {
          "const": "input.ai_model",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "$ref": "#/$defs/AiModelInputConfig"
        }
      },
      "required": [
        "id",
        "type",
        "config"
      ],
      "title": "AiModelInputNodeInput",
      "type": "object"
    },
    "ArtDirectionInputConfig": {
      "additionalProperties": false,
      "properties": {
        "art_direction_id": {
          "anyOf": [
            {
              "minimum": 1,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Art Direction Id"
        },
        "ask_at_run_time": {
          "default": false,
          "title": "Ask At Run Time",
          "type": "boolean"
        }
      },
      "title": "ArtDirectionInputConfig",
      "type": "object"
    },
    "ArtDirectionInputNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "type": {
          "const": "input.art_direction",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "$ref": "#/$defs/ArtDirectionInputConfig"
        }
      },
      "required": [
        "id",
        "type",
        "config"
      ],
      "title": "ArtDirectionInputNodeInput",
      "type": "object"
    },
    "AvatarInputConfig": {
      "additionalProperties": false,
      "properties": {
        "avatar_id": {
          "anyOf": [
            {
              "minimum": 1,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Avatar Id"
        },
        "ask_at_run_time": {
          "default": false,
          "title": "Ask At Run Time",
          "type": "boolean"
        }
      },
      "title": "AvatarInputConfig",
      "type": "object"
    },
    "AvatarInputNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "type": {
          "const": "input.avatar",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "$ref": "#/$defs/AvatarInputConfig"
        }
      },
      "required": [
        "id",
        "type",
        "config"
      ],
      "title": "AvatarInputNodeInput",
      "type": "object"
    },
    "BranchNodeConfig": {
      "additionalProperties": false,
      "properties": {
        "condition_type": {
          "const": "qa_decision",
          "title": "Condition Type",
          "type": "string"
        },
        "cases": {
          "additionalProperties": {
            "enum": [
              "accepted",
              "rejected",
              "error"
            ],
            "type": "string"
          },
          "minProperties": 1,
          "propertyNames": {
            "enum": [
              "accepted",
              "rejected",
              "error"
            ]
          },
          "title": "Cases",
          "type": "object"
        }
      },
      "required": [
        "condition_type",
        "cases"
      ],
      "title": "BranchNodeConfig",
      "type": "object"
    },
    "BranchNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "readiness": {
          "$ref": "#/$defs/ReadinessInput"
        },
        "infrastructure_retry": {
          "$ref": "#/$defs/InfrastructureRetryInput"
        },
        "type": {
          "const": "branch",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "$ref": "#/$defs/BranchNodeConfig"
        }
      },
      "required": [
        "id",
        "readiness",
        "infrastructure_retry",
        "type",
        "config"
      ],
      "title": "BranchNodeInput",
      "type": "object"
    },
    "ClothingInputConfig": {
      "additionalProperties": false,
      "properties": {
        "clothing_item_id": {
          "anyOf": [
            {
              "minimum": 1,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Clothing Item Id"
        },
        "ask_at_run_time": {
          "default": false,
          "title": "Ask At Run Time",
          "type": "boolean"
        }
      },
      "title": "ClothingInputConfig",
      "type": "object"
    },
    "ClothingInputNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "type": {
          "const": "input.clothing",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "$ref": "#/$defs/ClothingInputConfig"
        }
      },
      "required": [
        "id",
        "type",
        "config"
      ],
      "title": "ClothingInputNodeInput",
      "type": "object"
    },
    "DeliverTagDestination": {
      "additionalProperties": false,
      "properties": {
        "type": {
          "const": "tag",
          "title": "Type",
          "type": "string"
        },
        "tag_ids": {
          "items": {
            "type": "integer"
          },
          "maxItems": 50,
          "minItems": 1,
          "title": "Tag Ids",
          "type": "array"
        }
      },
      "required": [
        "type",
        "tag_ids"
      ],
      "title": "DeliverTagDestination",
      "type": "object"
    },
    "DeliverWebhookDestination": {
      "additionalProperties": false,
      "properties": {
        "type": {
          "const": "webhook",
          "title": "Type",
          "type": "string"
        },
        "webhook_id": {
          "format": "uuid",
          "title": "Webhook Id",
          "type": "string"
        },
        "event_type": {
          "pattern": "^workflow\\.[a-z0-9_.-]+$",
          "title": "Event Type",
          "type": "string"
        }
      },
      "required": [
        "type",
        "webhook_id",
        "event_type"
      ],
      "title": "DeliverWebhookDestination",
      "type": "object"
    },
    "EdgeBindingInput": {
      "additionalProperties": false,
      "properties": {
        "mode": {
          "enum": [
            "single",
            "collect"
          ],
          "title": "Mode",
          "type": "string"
        },
        "required": {
          "title": "Required",
          "type": "boolean"
        },
        "role": {
          "anyOf": [
            {
              "enum": [
                "background",
                "style"
              ],
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Role"
        }
      },
      "required": [
        "mode",
        "required"
      ],
      "title": "EdgeBindingInput",
      "type": "object"
    },
    "EdgeEndpointInput": {
      "additionalProperties": false,
      "properties": {
        "node_id": {
          "format": "uuid",
          "title": "Node Id",
          "type": "string"
        },
        "port": {
          "maxLength": 100,
          "minLength": 1,
          "title": "Port",
          "type": "string"
        }
      },
      "required": [
        "node_id",
        "port"
      ],
      "title": "EdgeEndpointInput",
      "type": "object"
    },
    "GenerateNodeConfig": {
      "additionalProperties": false,
      "properties": {
        "variant": {
          "enum": [
            "generate",
            "edit",
            "text_to_image"
          ],
          "title": "Variant",
          "type": "string"
        },
        "model_slug": {
          "maxLength": 100,
          "minLength": 1,
          "title": "Model Slug",
          "type": "string"
        },
        "parameters": {
          "additionalProperties": true,
          "title": "Parameters",
          "type": "object"
        }
      },
      "required": [
        "variant",
        "model_slug",
        "parameters"
      ],
      "title": "GenerateNodeConfig",
      "type": "object"
    },
    "GenerateNodeConfigV1_2": {
      "additionalProperties": false,
      "properties": {
        "variant": {
          "enum": [
            "generate",
            "edit",
            "text_to_image",
            "video"
          ],
          "title": "Variant",
          "type": "string"
        },
        "model_slug": {
          "maxLength": 100,
          "minLength": 1,
          "title": "Model Slug",
          "type": "string"
        },
        "parameters": {
          "additionalProperties": true,
          "title": "Parameters",
          "type": "object"
        }
      },
      "required": [
        "variant",
        "model_slug",
        "parameters"
      ],
      "title": "GenerateNodeConfigV1_2",
      "type": "object"
    },
    "GenerateNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "readiness": {
          "$ref": "#/$defs/ReadinessInput"
        },
        "infrastructure_retry": {
          "$ref": "#/$defs/InfrastructureRetryInput"
        },
        "type": {
          "const": "generate",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "anyOf": [
            {
              "$ref": "#/$defs/GenerateNodeConfig"
            },
            {
              "$ref": "#/$defs/GenerateNodeConfigV1_2"
            }
          ],
          "title": "Config"
        }
      },
      "required": [
        "id",
        "readiness",
        "infrastructure_retry",
        "type",
        "config"
      ],
      "title": "GenerateNodeInput",
      "type": "object"
    },
    "ImageInputConfig": {
      "additionalProperties": false,
      "properties": {
        "generation_result_id": {
          "anyOf": [
            {
              "minimum": 1,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Generation Result Id"
        },
        "ask_at_run_time": {
          "default": false,
          "title": "Ask At Run Time",
          "type": "boolean"
        }
      },
      "title": "ImageInputConfig",
      "type": "object"
    },
    "ImageInputNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "type": {
          "const": "input.image",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "$ref": "#/$defs/ImageInputConfig"
        }
      },
      "required": [
        "id",
        "type",
        "config"
      ],
      "title": "ImageInputNodeInput",
      "type": "object"
    },
    "InfrastructureRetryInput": {
      "additionalProperties": false,
      "properties": {
        "max_attempts": {
          "maximum": 20,
          "minimum": 1,
          "title": "Max Attempts",
          "type": "integer"
        },
        "initial_backoff_seconds": {
          "maximum": 86400,
          "minimum": 0,
          "title": "Initial Backoff Seconds",
          "type": "integer"
        },
        "max_backoff_seconds": {
          "maximum": 86400,
          "minimum": 0,
          "title": "Max Backoff Seconds",
          "type": "integer"
        }
      },
      "required": [
        "max_attempts",
        "initial_backoff_seconds",
        "max_backoff_seconds"
      ],
      "title": "InfrastructureRetryInput",
      "type": "object"
    },
    "LocationInputConfig": {
      "additionalProperties": false,
      "properties": {
        "location_id": {
          "anyOf": [
            {
              "minimum": 1,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Location Id"
        },
        "ask_at_run_time": {
          "default": false,
          "title": "Ask At Run Time",
          "type": "boolean"
        }
      },
      "title": "LocationInputConfig",
      "type": "object"
    },
    "LocationInputNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "type": {
          "const": "input.location",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "$ref": "#/$defs/LocationInputConfig"
        }
      },
      "required": [
        "id",
        "type",
        "config"
      ],
      "title": "LocationInputNodeInput",
      "type": "object"
    },
    "NotifyNodeConfig": {
      "additionalProperties": false,
      "properties": {
        "webhook_id": {
          "format": "uuid",
          "title": "Webhook Id",
          "type": "string"
        },
        "event_type": {
          "pattern": "^workflow\\.[a-z0-9_.-]+$",
          "title": "Event Type",
          "type": "string"
        }
      },
      "required": [
        "webhook_id",
        "event_type"
      ],
      "title": "NotifyNodeConfig",
      "type": "object"
    },
    "NotifyNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "readiness": {
          "$ref": "#/$defs/ReadinessInput"
        },
        "infrastructure_retry": {
          "$ref": "#/$defs/InfrastructureRetryInput"
        },
        "type": {
          "const": "notify",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "$ref": "#/$defs/NotifyNodeConfig"
        }
      },
      "required": [
        "id",
        "readiness",
        "infrastructure_retry",
        "type",
        "config"
      ],
      "title": "NotifyNodeInput",
      "type": "object"
    },
    "OutputNodeConfig": {
      "additionalProperties": false,
      "properties": {
        "projection": {
          "items": {
            "enum": [
              "artifacts",
              "qa",
              "billing",
              "provenance"
            ],
            "type": "string"
          },
          "minItems": 1,
          "title": "Projection",
          "type": "array"
        }
      },
      "required": [
        "projection"
      ],
      "title": "OutputNodeConfig",
      "type": "object"
    },
    "OutputNodeConfigV1_2": {
      "additionalProperties": false,
      "properties": {
        "projection": {
          "items": {
            "enum": [
              "artifacts",
              "qa",
              "billing",
              "provenance"
            ],
            "type": "string"
          },
          "minItems": 1,
          "title": "Projection",
          "type": "array"
        }
      },
      "title": "OutputNodeConfigV1_2",
      "type": "object"
    },
    "OutputNodeConfigV1_3": {
      "additionalProperties": false,
      "properties": {
        "destinations": {
          "items": {
            "discriminator": {
              "mapping": {
                "tag": "#/$defs/DeliverTagDestination",
                "webhook": "#/$defs/DeliverWebhookDestination"
              },
              "propertyName": "type"
            },
            "oneOf": [
              {
                "additionalProperties": false,
                "properties": {
                  "type": {
                    "const": "tag",
                    "title": "Type",
                    "type": "string"
                  },
                  "tag_ids": {
                    "items": {
                      "type": "integer"
                    },
                    "maxItems": 50,
                    "minItems": 1,
                    "title": "Tag Ids",
                    "type": "array"
                  }
                },
                "required": [
                  "type",
                  "tag_ids"
                ],
                "title": "DeliverTagDestination",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "type": {
                    "const": "webhook",
                    "title": "Type",
                    "type": "string"
                  },
                  "webhook_id": {
                    "format": "uuid",
                    "title": "Webhook Id",
                    "type": "string"
                  },
                  "event_type": {
                    "pattern": "^workflow\\.[a-z0-9_.-]+$",
                    "title": "Event Type",
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "webhook_id",
                  "event_type"
                ],
                "title": "DeliverWebhookDestination",
                "type": "object"
              }
            ],
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "tag",
                  "webhook"
                ]
              },
              "tag_ids": {
                "items": {
                  "type": "integer"
                },
                "maxItems": 50,
                "minItems": 1,
                "title": "Tag Ids",
                "type": "array"
              },
              "webhook_id": {
                "format": "uuid",
                "title": "Webhook Id",
                "type": "string"
              },
              "event_type": {
                "pattern": "^workflow\\.[a-z0-9_.-]+$",
                "title": "Event Type",
                "type": "string"
              }
            }
          },
          "maxItems": 20,
          "title": "Destinations",
          "type": "array"
        },
        "projection": {
          "anyOf": [
            {
              "items": {
                "enum": [
                  "artifacts",
                  "qa",
                  "billing",
                  "provenance"
                ],
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Projection"
        }
      },
      "title": "OutputNodeConfigV1_3",
      "type": "object"
    },
    "OutputNodeConfigV1_4": {
      "additionalProperties": false,
      "properties": {
        "destinations": {
          "items": {
            "discriminator": {
              "mapping": {
                "tag": "#/$defs/DeliverTagDestination",
                "webhook": "#/$defs/DeliverWebhookDestination"
              },
              "propertyName": "type"
            },
            "oneOf": [
              {
                "additionalProperties": false,
                "properties": {
                  "type": {
                    "const": "tag",
                    "title": "Type",
                    "type": "string"
                  },
                  "tag_ids": {
                    "items": {
                      "type": "integer"
                    },
                    "maxItems": 50,
                    "minItems": 1,
                    "title": "Tag Ids",
                    "type": "array"
                  }
                },
                "required": [
                  "type",
                  "tag_ids"
                ],
                "title": "DeliverTagDestination",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "type": {
                    "const": "webhook",
                    "title": "Type",
                    "type": "string"
                  },
                  "webhook_id": {
                    "format": "uuid",
                    "title": "Webhook Id",
                    "type": "string"
                  },
                  "event_type": {
                    "pattern": "^workflow\\.[a-z0-9_.-]+$",
                    "title": "Event Type",
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "webhook_id",
                  "event_type"
                ],
                "title": "DeliverWebhookDestination",
                "type": "object"
              }
            ],
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "tag",
                  "webhook"
                ]
              },
              "tag_ids": {
                "items": {
                  "type": "integer"
                },
                "maxItems": 50,
                "minItems": 1,
                "title": "Tag Ids",
                "type": "array"
              },
              "webhook_id": {
                "format": "uuid",
                "title": "Webhook Id",
                "type": "string"
              },
              "event_type": {
                "pattern": "^workflow\\.[a-z0-9_.-]+$",
                "title": "Event Type",
                "type": "string"
              }
            }
          },
          "maxItems": 20,
          "title": "Destinations",
          "type": "array"
        }
      },
      "title": "OutputNodeConfigV1_4",
      "type": "object"
    },
    "OutputNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "readiness": {
          "$ref": "#/$defs/ReadinessInput"
        },
        "infrastructure_retry": {
          "$ref": "#/$defs/InfrastructureRetryInput"
        },
        "type": {
          "const": "output",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "anyOf": [
            {
              "$ref": "#/$defs/OutputNodeConfig"
            },
            {
              "$ref": "#/$defs/OutputNodeConfigV1_2"
            },
            {
              "$ref": "#/$defs/OutputNodeConfigV1_3"
            },
            {
              "$ref": "#/$defs/OutputNodeConfigV1_4"
            }
          ],
          "title": "Config"
        }
      },
      "required": [
        "id",
        "readiness",
        "infrastructure_retry",
        "type",
        "config"
      ],
      "title": "OutputNodeInput",
      "type": "object"
    },
    "PromptInputConfig": {
      "additionalProperties": false,
      "properties": {
        "text": {
          "anyOf": [
            {
              "maxLength": 10000,
              "minLength": 1,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Text"
        },
        "ask_at_run_time": {
          "default": false,
          "title": "Ask At Run Time",
          "type": "boolean"
        }
      },
      "title": "PromptInputConfig",
      "type": "object"
    },
    "PromptInputNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "type": {
          "const": "input.prompt",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "$ref": "#/$defs/PromptInputConfig"
        }
      },
      "required": [
        "id",
        "type",
        "config"
      ],
      "title": "PromptInputNodeInput",
      "type": "object"
    },
    "QaGateNodeConfig": {
      "additionalProperties": false,
      "properties": {
        "policy": {
          "maxLength": 100,
          "minLength": 1,
          "title": "Policy",
          "type": "string"
        },
        "max_content_retries": {
          "maximum": 20,
          "minimum": 0,
          "title": "Max Content Retries",
          "type": "integer"
        }
      },
      "required": [
        "policy",
        "max_content_retries"
      ],
      "title": "QaGateNodeConfig",
      "type": "object"
    },
    "QaGateNodeConfigV1_2": {
      "additionalProperties": false,
      "properties": {
        "policy": {
          "maxLength": 100,
          "minLength": 1,
          "title": "Policy",
          "type": "string"
        },
        "max_content_retries": {
          "maximum": 20,
          "minimum": 0,
          "title": "Max Content Retries",
          "type": "integer"
        },
        "graph_retry": {
          "anyOf": [
            {
              "$ref": "#/$defs/QaGraphRetryConfig"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "required": [
        "policy",
        "max_content_retries"
      ],
      "title": "QaGateNodeConfigV1_2",
      "type": "object"
    },
    "QaGateNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "readiness": {
          "$ref": "#/$defs/ReadinessInput"
        },
        "infrastructure_retry": {
          "$ref": "#/$defs/InfrastructureRetryInput"
        },
        "type": {
          "const": "qa_gate",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "anyOf": [
            {
              "$ref": "#/$defs/QaGateNodeConfig"
            },
            {
              "$ref": "#/$defs/QaGateNodeConfigV1_2"
            }
          ],
          "title": "Config"
        }
      },
      "required": [
        "id",
        "readiness",
        "infrastructure_retry",
        "type",
        "config"
      ],
      "title": "QaGateNodeInput",
      "type": "object"
    },
    "QaGraphRetryConfig": {
      "additionalProperties": false,
      "properties": {
        "retry_from_node_id": {
          "format": "uuid",
          "title": "Retry From Node Id",
          "type": "string"
        },
        "max_retries": {
          "maximum": 20,
          "minimum": 1,
          "title": "Max Retries",
          "type": "integer"
        }
      },
      "required": [
        "retry_from_node_id",
        "max_retries"
      ],
      "title": "QaGraphRetryConfig",
      "type": "object"
    },
    "ReadinessInput": {
      "additionalProperties": false,
      "properties": {
        "mode": {
          "enum": [
            "all_required",
            "all_terminal"
          ],
          "title": "Mode",
          "type": "string"
        }
      },
      "required": [
        "mode"
      ],
      "title": "ReadinessInput",
      "type": "object"
    },
    "TriggerNodeConfig": {
      "additionalProperties": false,
      "properties": {
        "source": {
          "pattern": "^[a-z][a-z0-9_-]*(\\.[a-z][a-z0-9_-]*)+$",
          "title": "Source",
          "type": "string"
        },
        "settings": {
          "additionalProperties": true,
          "title": "Settings",
          "type": "object"
        }
      },
      "required": [
        "source",
        "settings"
      ],
      "title": "TriggerNodeConfig",
      "type": "object"
    },
    "TriggerNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "type": {
          "const": "trigger",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "$ref": "#/$defs/TriggerNodeConfig"
        }
      },
      "required": [
        "id",
        "type",
        "config"
      ],
      "title": "TriggerNodeInput",
      "type": "object"
    },
    "WorkflowEdgeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "source": {
          "$ref": "#/$defs/EdgeEndpointInput"
        },
        "target": {
          "$ref": "#/$defs/EdgeEndpointInput"
        },
        "binding": {
          "$ref": "#/$defs/EdgeBindingInput"
        }
      },
      "required": [
        "id",
        "source",
        "target",
        "binding"
      ],
      "title": "WorkflowEdgeInput",
      "type": "object"
    },
    "WorkflowFailurePolicy": {
      "enum": [
        "fail_fast",
        "continue_independent"
      ],
      "title": "WorkflowFailurePolicy",
      "type": "string"
    },
    "WorkflowVersionCreate": {
      "additionalProperties": false,
      "properties": {
        "contract_version": {
          "default": "1.0",
          "enum": [
            "1.0",
            "1.1",
            "1.2",
            "1.3",
            "1.4",
            "1.5"
          ],
          "title": "Contract Version",
          "type": "string"
        },
        "failure_policy": {
          "$ref": "#/$defs/WorkflowFailurePolicy"
        },
        "result_projection": {
          "items": {
            "enum": [
              "artifacts",
              "qa",
              "billing",
              "provenance"
            ],
            "type": "string"
          },
          "minItems": 1,
          "title": "Result Projection",
          "type": "array"
        },
        "nodes": {
          "items": {
            "discriminator": {
              "mapping": {
                "branch": "#/$defs/BranchNodeInput",
                "generate": "#/$defs/GenerateNodeInput",
                "input.ai_model": "#/$defs/AiModelInputNodeInput",
                "input.art_direction": "#/$defs/ArtDirectionInputNodeInput",
                "input.avatar": "#/$defs/AvatarInputNodeInput",
                "input.clothing": "#/$defs/ClothingInputNodeInput",
                "input.image": "#/$defs/ImageInputNodeInput",
                "input.location": "#/$defs/LocationInputNodeInput",
                "input.prompt": "#/$defs/PromptInputNodeInput",
                "notify": "#/$defs/NotifyNodeInput",
                "output": "#/$defs/OutputNodeInput",
                "qa_gate": "#/$defs/QaGateNodeInput",
                "trigger": "#/$defs/TriggerNodeInput"
              },
              "propertyName": "type"
            },
            "oneOf": [
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "type": {
                    "const": "trigger",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "additionalProperties": false,
                    "properties": {
                      "source": {
                        "pattern": "^[a-z][a-z0-9_-]*(\\.[a-z][a-z0-9_-]*)+$",
                        "title": "Source",
                        "type": "string"
                      },
                      "settings": {
                        "additionalProperties": true,
                        "title": "Settings",
                        "type": "object"
                      }
                    },
                    "required": [
                      "source",
                      "settings"
                    ],
                    "title": "TriggerNodeConfig",
                    "type": "object"
                  }
                },
                "required": [
                  "id",
                  "type",
                  "config"
                ],
                "title": "TriggerNodeInput",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "readiness": {
                    "additionalProperties": false,
                    "properties": {
                      "mode": {
                        "enum": [
                          "all_required",
                          "all_terminal"
                        ],
                        "title": "Mode",
                        "type": "string"
                      }
                    },
                    "required": [
                      "mode"
                    ],
                    "title": "ReadinessInput",
                    "type": "object"
                  },
                  "infrastructure_retry": {
                    "additionalProperties": false,
                    "properties": {
                      "max_attempts": {
                        "maximum": 20,
                        "minimum": 1,
                        "title": "Max Attempts",
                        "type": "integer"
                      },
                      "initial_backoff_seconds": {
                        "maximum": 86400,
                        "minimum": 0,
                        "title": "Initial Backoff Seconds",
                        "type": "integer"
                      },
                      "max_backoff_seconds": {
                        "maximum": 86400,
                        "minimum": 0,
                        "title": "Max Backoff Seconds",
                        "type": "integer"
                      }
                    },
                    "required": [
                      "max_attempts",
                      "initial_backoff_seconds",
                      "max_backoff_seconds"
                    ],
                    "title": "InfrastructureRetryInput",
                    "type": "object"
                  },
                  "type": {
                    "const": "generate",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "anyOf": [
                      {
                        "additionalProperties": false,
                        "properties": {
                          "variant": {
                            "enum": [
                              "generate",
                              "edit",
                              "text_to_image"
                            ],
                            "title": "Variant",
                            "type": "string"
                          },
                          "model_slug": {
                            "maxLength": 100,
                            "minLength": 1,
                            "title": "Model Slug",
                            "type": "string"
                          },
                          "parameters": {
                            "additionalProperties": true,
                            "title": "Parameters",
                            "type": "object"
                          }
                        },
                        "required": [
                          "variant",
                          "model_slug",
                          "parameters"
                        ],
                        "title": "GenerateNodeConfig",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "variant": {
                            "enum": [
                              "generate",
                              "edit",
                              "text_to_image",
                              "video"
                            ],
                            "title": "Variant",
                            "type": "string"
                          },
                          "model_slug": {
                            "maxLength": 100,
                            "minLength": 1,
                            "title": "Model Slug",
                            "type": "string"
                          },
                          "parameters": {
                            "additionalProperties": true,
                            "title": "Parameters",
                            "type": "object"
                          }
                        },
                        "required": [
                          "variant",
                          "model_slug",
                          "parameters"
                        ],
                        "title": "GenerateNodeConfigV1_2",
                        "type": "object"
                      }
                    ],
                    "title": "Config"
                  }
                },
                "required": [
                  "id",
                  "readiness",
                  "infrastructure_retry",
                  "type",
                  "config"
                ],
                "title": "GenerateNodeInput",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "readiness": {
                    "additionalProperties": false,
                    "properties": {
                      "mode": {
                        "enum": [
                          "all_required",
                          "all_terminal"
                        ],
                        "title": "Mode",
                        "type": "string"
                      }
                    },
                    "required": [
                      "mode"
                    ],
                    "title": "ReadinessInput",
                    "type": "object"
                  },
                  "infrastructure_retry": {
                    "additionalProperties": false,
                    "properties": {
                      "max_attempts": {
                        "maximum": 20,
                        "minimum": 1,
                        "title": "Max Attempts",
                        "type": "integer"
                      },
                      "initial_backoff_seconds": {
                        "maximum": 86400,
                        "minimum": 0,
                        "title": "Initial Backoff Seconds",
                        "type": "integer"
                      },
                      "max_backoff_seconds": {
                        "maximum": 86400,
                        "minimum": 0,
                        "title": "Max Backoff Seconds",
                        "type": "integer"
                      }
                    },
                    "required": [
                      "max_attempts",
                      "initial_backoff_seconds",
                      "max_backoff_seconds"
                    ],
                    "title": "InfrastructureRetryInput",
                    "type": "object"
                  },
                  "type": {
                    "const": "qa_gate",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "anyOf": [
                      {
                        "additionalProperties": false,
                        "properties": {
                          "policy": {
                            "maxLength": 100,
                            "minLength": 1,
                            "title": "Policy",
                            "type": "string"
                          },
                          "max_content_retries": {
                            "maximum": 20,
                            "minimum": 0,
                            "title": "Max Content Retries",
                            "type": "integer"
                          }
                        },
                        "required": [
                          "policy",
                          "max_content_retries"
                        ],
                        "title": "QaGateNodeConfig",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "policy": {
                            "maxLength": 100,
                            "minLength": 1,
                            "title": "Policy",
                            "type": "string"
                          },
                          "max_content_retries": {
                            "maximum": 20,
                            "minimum": 0,
                            "title": "Max Content Retries",
                            "type": "integer"
                          },
                          "graph_retry": {
                            "anyOf": [
                              {
                                "additionalProperties": false,
                                "properties": {
                                  "retry_from_node_id": {
                                    "format": "uuid",
                                    "title": "Retry From Node Id",
                                    "type": "string"
                                  },
                                  "max_retries": {
                                    "maximum": 20,
                                    "minimum": 1,
                                    "title": "Max Retries",
                                    "type": "integer"
                                  }
                                },
                                "required": [
                                  "retry_from_node_id",
                                  "max_retries"
                                ],
                                "title": "QaGraphRetryConfig",
                                "type": "object"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "default": null
                          }
                        },
                        "required": [
                          "policy",
                          "max_content_retries"
                        ],
                        "title": "QaGateNodeConfigV1_2",
                        "type": "object"
                      }
                    ],
                    "title": "Config"
                  }
                },
                "required": [
                  "id",
                  "readiness",
                  "infrastructure_retry",
                  "type",
                  "config"
                ],
                "title": "QaGateNodeInput",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "readiness": {
                    "additionalProperties": false,
                    "properties": {
                      "mode": {
                        "enum": [
                          "all_required",
                          "all_terminal"
                        ],
                        "title": "Mode",
                        "type": "string"
                      }
                    },
                    "required": [
                      "mode"
                    ],
                    "title": "ReadinessInput",
                    "type": "object"
                  },
                  "infrastructure_retry": {
                    "additionalProperties": false,
                    "properties": {
                      "max_attempts": {
                        "maximum": 20,
                        "minimum": 1,
                        "title": "Max Attempts",
                        "type": "integer"
                      },
                      "initial_backoff_seconds": {
                        "maximum": 86400,
                        "minimum": 0,
                        "title": "Initial Backoff Seconds",
                        "type": "integer"
                      },
                      "max_backoff_seconds": {
                        "maximum": 86400,
                        "minimum": 0,
                        "title": "Max Backoff Seconds",
                        "type": "integer"
                      }
                    },
                    "required": [
                      "max_attempts",
                      "initial_backoff_seconds",
                      "max_backoff_seconds"
                    ],
                    "title": "InfrastructureRetryInput",
                    "type": "object"
                  },
                  "type": {
                    "const": "branch",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "additionalProperties": false,
                    "properties": {
                      "condition_type": {
                        "const": "qa_decision",
                        "title": "Condition Type",
                        "type": "string"
                      },
                      "cases": {
                        "additionalProperties": {
                          "enum": [
                            "accepted",
                            "rejected",
                            "error"
                          ],
                          "type": "string"
                        },
                        "minProperties": 1,
                        "propertyNames": {
                          "enum": [
                            "accepted",
                            "rejected",
                            "error"
                          ]
                        },
                        "title": "Cases",
                        "type": "object"
                      }
                    },
                    "required": [
                      "condition_type",
                      "cases"
                    ],
                    "title": "BranchNodeConfig",
                    "type": "object"
                  }
                },
                "required": [
                  "id",
                  "readiness",
                  "infrastructure_retry",
                  "type",
                  "config"
                ],
                "title": "BranchNodeInput",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "readiness": {
                    "additionalProperties": false,
                    "properties": {
                      "mode": {
                        "enum": [
                          "all_required",
                          "all_terminal"
                        ],
                        "title": "Mode",
                        "type": "string"
                      }
                    },
                    "required": [
                      "mode"
                    ],
                    "title": "ReadinessInput",
                    "type": "object"
                  },
                  "infrastructure_retry": {
                    "additionalProperties": false,
                    "properties": {
                      "max_attempts": {
                        "maximum": 20,
                        "minimum": 1,
                        "title": "Max Attempts",
                        "type": "integer"
                      },
                      "initial_backoff_seconds": {
                        "maximum": 86400,
                        "minimum": 0,
                        "title": "Initial Backoff Seconds",
                        "type": "integer"
                      },
                      "max_backoff_seconds": {
                        "maximum": 86400,
                        "minimum": 0,
                        "title": "Max Backoff Seconds",
                        "type": "integer"
                      }
                    },
                    "required": [
                      "max_attempts",
                      "initial_backoff_seconds",
                      "max_backoff_seconds"
                    ],
                    "title": "InfrastructureRetryInput",
                    "type": "object"
                  },
                  "type": {
                    "const": "output",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "anyOf": [
                      {
                        "additionalProperties": false,
                        "properties": {
                          "projection": {
                            "items": {
                              "enum": [
                                "artifacts",
                                "qa",
                                "billing",
                                "provenance"
                              ],
                              "type": "string"
                            },
                            "minItems": 1,
                            "title": "Projection",
                            "type": "array"
                          }
                        },
                        "required": [
                          "projection"
                        ],
                        "title": "OutputNodeConfig",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "projection": {
                            "items": {
                              "enum": [
                                "artifacts",
                                "qa",
                                "billing",
                                "provenance"
                              ],
                              "type": "string"
                            },
                            "minItems": 1,
                            "title": "Projection",
                            "type": "array"
                          }
                        },
                        "title": "OutputNodeConfigV1_2",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "destinations": {
                            "items": {
                              "discriminator": {
                                "mapping": {
                                  "tag": "#/$defs/DeliverTagDestination",
                                  "webhook": "#/$defs/DeliverWebhookDestination"
                                },
                                "propertyName": "type"
                              },
                              "oneOf": [
                                {
                                  "additionalProperties": false,
                                  "properties": {
                                    "type": {
                                      "const": "tag",
                                      "title": "Type",
                                      "type": "string"
                                    },
                                    "tag_ids": {
                                      "items": {
                                        "type": "integer"
                                      },
                                      "maxItems": 50,
                                      "minItems": 1,
                                      "title": "Tag Ids",
                                      "type": "array"
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "tag_ids"
                                  ],
                                  "title": "DeliverTagDestination",
                                  "type": "object"
                                },
                                {
                                  "additionalProperties": false,
                                  "properties": {
                                    "type": {
                                      "const": "webhook",
                                      "title": "Type",
                                      "type": "string"
                                    },
                                    "webhook_id": {
                                      "format": "uuid",
                                      "title": "Webhook Id",
                                      "type": "string"
                                    },
                                    "event_type": {
                                      "pattern": "^workflow\\.[a-z0-9_.-]+$",
                                      "title": "Event Type",
                                      "type": "string"
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "webhook_id",
                                    "event_type"
                                  ],
                                  "title": "DeliverWebhookDestination",
                                  "type": "object"
                                }
                              ],
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "tag",
                                    "webhook"
                                  ]
                                },
                                "tag_ids": {
                                  "items": {
                                    "type": "integer"
                                  },
                                  "maxItems": 50,
                                  "minItems": 1,
                                  "title": "Tag Ids",
                                  "type": "array"
                                },
                                "webhook_id": {
                                  "format": "uuid",
                                  "title": "Webhook Id",
                                  "type": "string"
                                },
                                "event_type": {
                                  "pattern": "^workflow\\.[a-z0-9_.-]+$",
                                  "title": "Event Type",
                                  "type": "string"
                                }
                              }
                            },
                            "maxItems": 20,
                            "title": "Destinations",
                            "type": "array"
                          },
                          "projection": {
                            "anyOf": [
                              {
                                "items": {
                                  "enum": [
                                    "artifacts",
                                    "qa",
                                    "billing",
                                    "provenance"
                                  ],
                                  "type": "string"
                                },
                                "type": "array"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "default": null,
                            "title": "Projection"
                          }
                        },
                        "title": "OutputNodeConfigV1_3",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "destinations": {
                            "items": {
                              "discriminator": {
                                "mapping": {
                                  "tag": "#/$defs/DeliverTagDestination",
                                  "webhook": "#/$defs/DeliverWebhookDestination"
                                },
                                "propertyName": "type"
                              },
                              "oneOf": [
                                {
                                  "additionalProperties": false,
                                  "properties": {
                                    "type": {
                                      "const": "tag",
                                      "title": "Type",
                                      "type": "string"
                                    },
                                    "tag_ids": {
                                      "items": {
                                        "type": "integer"
                                      },
                                      "maxItems": 50,
                                      "minItems": 1,
                                      "title": "Tag Ids",
                                      "type": "array"
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "tag_ids"
                                  ],
                                  "title": "DeliverTagDestination",
                                  "type": "object"
                                },
                                {
                                  "additionalProperties": false,
                                  "properties": {
                                    "type": {
                                      "const": "webhook",
                                      "title": "Type",
                                      "type": "string"
                                    },
                                    "webhook_id": {
                                      "format": "uuid",
                                      "title": "Webhook Id",
                                      "type": "string"
                                    },
                                    "event_type": {
                                      "pattern": "^workflow\\.[a-z0-9_.-]+$",
                                      "title": "Event Type",
                                      "type": "string"
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "webhook_id",
                                    "event_type"
                                  ],
                                  "title": "DeliverWebhookDestination",
                                  "type": "object"
                                }
                              ],
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "tag",
                                    "webhook"
                                  ]
                                },
                                "tag_ids": {
                                  "items": {
                                    "type": "integer"
                                  },
                                  "maxItems": 50,
                                  "minItems": 1,
                                  "title": "Tag Ids",
                                  "type": "array"
                                },
                                "webhook_id": {
                                  "format": "uuid",
                                  "title": "Webhook Id",
                                  "type": "string"
                                },
                                "event_type": {
                                  "pattern": "^workflow\\.[a-z0-9_.-]+$",
                                  "title": "Event Type",
                                  "type": "string"
                                }
                              }
                            },
                            "maxItems": 20,
                            "title": "Destinations",
                            "type": "array"
                          }
                        },
                        "title": "OutputNodeConfigV1_4",
                        "type": "object"
                      }
                    ],
                    "title": "Config"
                  }
                },
                "required": [
                  "id",
                  "readiness",
                  "infrastructure_retry",
                  "type",
                  "config"
                ],
                "title": "OutputNodeInput",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "readiness": {
                    "additionalProperties": false,
                    "properties": {
                      "mode": {
                        "enum": [
                          "all_required",
                          "all_terminal"
                        ],
                        "title": "Mode",
                        "type": "string"
                      }
                    },
                    "required": [
                      "mode"
                    ],
                    "title": "ReadinessInput",
                    "type": "object"
                  },
                  "infrastructure_retry": {
                    "additionalProperties": false,
                    "properties": {
                      "max_attempts": {
                        "maximum": 20,
                        "minimum": 1,
                        "title": "Max Attempts",
                        "type": "integer"
                      },
                      "initial_backoff_seconds": {
                        "maximum": 86400,
                        "minimum": 0,
                        "title": "Initial Backoff Seconds",
                        "type": "integer"
                      },
                      "max_backoff_seconds": {
                        "maximum": 86400,
                        "minimum": 0,
                        "title": "Max Backoff Seconds",
                        "type": "integer"
                      }
                    },
                    "required": [
                      "max_attempts",
                      "initial_backoff_seconds",
                      "max_backoff_seconds"
                    ],
                    "title": "InfrastructureRetryInput",
                    "type": "object"
                  },
                  "type": {
                    "const": "notify",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "additionalProperties": false,
                    "properties": {
                      "webhook_id": {
                        "format": "uuid",
                        "title": "Webhook Id",
                        "type": "string"
                      },
                      "event_type": {
                        "pattern": "^workflow\\.[a-z0-9_.-]+$",
                        "title": "Event Type",
                        "type": "string"
                      }
                    },
                    "required": [
                      "webhook_id",
                      "event_type"
                    ],
                    "title": "NotifyNodeConfig",
                    "type": "object"
                  }
                },
                "required": [
                  "id",
                  "readiness",
                  "infrastructure_retry",
                  "type",
                  "config"
                ],
                "title": "NotifyNodeInput",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "type": {
                    "const": "input.avatar",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "additionalProperties": false,
                    "properties": {
                      "avatar_id": {
                        "anyOf": [
                          {
                            "minimum": 1,
                            "type": "integer"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "default": null,
                        "title": "Avatar Id"
                      },
                      "ask_at_run_time": {
                        "default": false,
                        "title": "Ask At Run Time",
                        "type": "boolean"
                      }
                    },
                    "title": "AvatarInputConfig",
                    "type": "object"
                  }
                },
                "required": [
                  "id",
                  "type",
                  "config"
                ],
                "title": "AvatarInputNodeInput",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "type": {
                    "const": "input.clothing",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "additionalProperties": false,
                    "properties": {
                      "clothing_item_id": {
                        "anyOf": [
                          {
                            "minimum": 1,
                            "type": "integer"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "default": null,
                        "title": "Clothing Item Id"
                      },
                      "ask_at_run_time": {
                        "default": false,
                        "title": "Ask At Run Time",
                        "type": "boolean"
                      }
                    },
                    "title": "ClothingInputConfig",
                    "type": "object"
                  }
                },
                "required": [
                  "id",
                  "type",
                  "config"
                ],
                "title": "ClothingInputNodeInput",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "type": {
                    "const": "input.location",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "additionalProperties": false,
                    "properties": {
                      "location_id": {
                        "anyOf": [
                          {
                            "minimum": 1,
                            "type": "integer"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "default": null,
                        "title": "Location Id"
                      },
                      "ask_at_run_time": {
                        "default": false,
                        "title": "Ask At Run Time",
                        "type": "boolean"
                      }
                    },
                    "title": "LocationInputConfig",
                    "type": "object"
                  }
                },
                "required": [
                  "id",
                  "type",
                  "config"
                ],
                "title": "LocationInputNodeInput",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "type": {
                    "const": "input.art_direction",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "additionalProperties": false,
                    "properties": {
                      "art_direction_id": {
                        "anyOf": [
                          {
                            "minimum": 1,
                            "type": "integer"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "default": null,
                        "title": "Art Direction Id"
                      },
                      "ask_at_run_time": {
                        "default": false,
                        "title": "Ask At Run Time",
                        "type": "boolean"
                      }
                    },
                    "title": "ArtDirectionInputConfig",
                    "type": "object"
                  }
                },
                "required": [
                  "id",
                  "type",
                  "config"
                ],
                "title": "ArtDirectionInputNodeInput",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "type": {
                    "const": "input.prompt",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "additionalProperties": false,
                    "properties": {
                      "text": {
                        "anyOf": [
                          {
                            "maxLength": 10000,
                            "minLength": 1,
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "default": null,
                        "title": "Text"
                      },
                      "ask_at_run_time": {
                        "default": false,
                        "title": "Ask At Run Time",
                        "type": "boolean"
                      }
                    },
                    "title": "PromptInputConfig",
                    "type": "object"
                  }
                },
                "required": [
                  "id",
                  "type",
                  "config"
                ],
                "title": "PromptInputNodeInput",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "type": {
                    "const": "input.image",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "additionalProperties": false,
                    "properties": {
                      "generation_result_id": {
                        "anyOf": [
                          {
                            "minimum": 1,
                            "type": "integer"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "default": null,
                        "title": "Generation Result Id"
                      },
                      "ask_at_run_time": {
                        "default": false,
                        "title": "Ask At Run Time",
                        "type": "boolean"
                      }
                    },
                    "title": "ImageInputConfig",
                    "type": "object"
                  }
                },
                "required": [
                  "id",
                  "type",
                  "config"
                ],
                "title": "ImageInputNodeInput",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "type": {
                    "const": "input.ai_model",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "additionalProperties": false,
                    "properties": {
                      "model_slug": {
                        "anyOf": [
                          {
                            "maxLength": 100,
                            "minLength": 1,
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "default": null,
                        "title": "Model Slug"
                      }
                    },
                    "title": "AiModelInputConfig",
                    "type": "object"
                  }
                },
                "required": [
                  "id",
                  "type",
                  "config"
                ],
                "title": "AiModelInputNodeInput",
                "type": "object"
              }
            ],
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "trigger",
                  "generate",
                  "qa_gate",
                  "branch",
                  "output",
                  "notify",
                  "input.avatar",
                  "input.clothing",
                  "input.location",
                  "input.art_direction",
                  "input.prompt",
                  "input.image",
                  "input.ai_model"
                ]
              },
              "id": {
                "format": "uuid",
                "title": "Id",
                "type": "string"
              },
              "config": {
                "additionalProperties": false,
                "properties": {
                  "source": {
                    "pattern": "^[a-z][a-z0-9_-]*(\\.[a-z][a-z0-9_-]*)+$",
                    "title": "Source",
                    "type": "string"
                  },
                  "settings": {
                    "additionalProperties": true,
                    "title": "Settings",
                    "type": "object"
                  }
                },
                "required": [
                  "source",
                  "settings"
                ],
                "title": "TriggerNodeConfig",
                "type": "object"
              },
              "readiness": {
                "additionalProperties": false,
                "properties": {
                  "mode": {
                    "enum": [
                      "all_required",
                      "all_terminal"
                    ],
                    "title": "Mode",
                    "type": "string"
                  }
                },
                "required": [
                  "mode"
                ],
                "title": "ReadinessInput",
                "type": "object"
              },
              "infrastructure_retry": {
                "additionalProperties": false,
                "properties": {
                  "max_attempts": {
                    "maximum": 20,
                    "minimum": 1,
                    "title": "Max Attempts",
                    "type": "integer"
                  },
                  "initial_backoff_seconds": {
                    "maximum": 86400,
                    "minimum": 0,
                    "title": "Initial Backoff Seconds",
                    "type": "integer"
                  },
                  "max_backoff_seconds": {
                    "maximum": 86400,
                    "minimum": 0,
                    "title": "Max Backoff Seconds",
                    "type": "integer"
                  }
                },
                "required": [
                  "max_attempts",
                  "initial_backoff_seconds",
                  "max_backoff_seconds"
                ],
                "title": "InfrastructureRetryInput",
                "type": "object"
              }
            }
          },
          "minItems": 2,
          "title": "Nodes",
          "type": "array"
        },
        "edges": {
          "items": {
            "$ref": "#/$defs/WorkflowEdgeInput"
          },
          "minItems": 1,
          "title": "Edges",
          "type": "array"
        },
        "base_version_id": {
          "anyOf": [
            {
              "format": "uuid",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Base Version Id"
        }
      },
      "required": [
        "failure_policy",
        "nodes",
        "edges"
      ],
      "title": "WorkflowVersionCreate",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "title": "CreateWorkflowVersionInput"
}

list_production_workflow_versions

List a workflow's versions and their state.

Parameters3

workflow_id	string	required	Workflow ID
page	integer	optional	Page number for workflow version results
items_per_page	integer	optional	Number of workflow versions per page

Raw schema

{
  "type": "object",
  "properties": {
    "workflow_id": {
      "description": "Workflow ID",
      "format": "uuid",
      "title": "Workflow Id",
      "type": "string"
    },
    "page": {
      "default": 1,
      "description": "Page number for workflow version results",
      "minimum": 1,
      "title": "Page",
      "type": "integer"
    },
    "items_per_page": {
      "default": 50,
      "description": "Number of workflow versions per page",
      "maximum": 100,
      "minimum": 1,
      "title": "Items Per Page",
      "type": "integer"
    }
  },
  "required": [
    "workflow_id"
  ],
  "additionalProperties": false,
  "title": "ListWorkflowVersionsInput"
}

get_production_workflow_version

Read one version's full graph. See uwear://contracts/production-workflow for typed node configs and worked examples.

Parameters2

workflow_id	string	required	Workflow ID
version_id	string	required	Workflow version ID

Raw schema

{
  "type": "object",
  "properties": {
    "workflow_id": {
      "description": "Workflow ID",
      "format": "uuid",
      "title": "Workflow Id",
      "type": "string"
    },
    "version_id": {
      "description": "Workflow version ID",
      "format": "uuid",
      "title": "Version Id",
      "type": "string"
    }
  },
  "required": [
    "workflow_id",
    "version_id"
  ],
  "additionalProperties": false,
  "title": "WorkflowVersionIdentityInput"
}

update_production_workflow_version

Replace a draft's graph. Published versions are immutable — branch a new draft instead. See uwear://contracts/production-workflow for typed node configs and worked examples.

Parameters3

workflow_id	string	required	Workflow ID
version_id	string	required	Workflow version ID
update	any	required	Draft version fields to update: failure policy, nodes, or edges

Raw schema

{
  "type": "object",
  "properties": {
    "workflow_id": {
      "description": "Workflow ID",
      "format": "uuid",
      "title": "Workflow Id",
      "type": "string"
    },
    "version_id": {
      "description": "Workflow version ID",
      "format": "uuid",
      "title": "Version Id",
      "type": "string"
    },
    "update": {
      "$ref": "#/$defs/WorkflowVersionUpdate",
      "description": "Draft version fields to update: failure policy, nodes, or edges"
    }
  },
  "required": [
    "workflow_id",
    "version_id",
    "update"
  ],
  "$defs": {
    "AiModelInputConfig": {
      "additionalProperties": false,
      "properties": {
        "model_slug": {
          "anyOf": [
            {
              "maxLength": 100,
              "minLength": 1,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Model Slug"
        }
      },
      "title": "AiModelInputConfig",
      "type": "object"
    },
    "AiModelInputNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "type": {
          "const": "input.ai_model",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "$ref": "#/$defs/AiModelInputConfig"
        }
      },
      "required": [
        "id",
        "type",
        "config"
      ],
      "title": "AiModelInputNodeInput",
      "type": "object"
    },
    "ArtDirectionInputConfig": {
      "additionalProperties": false,
      "properties": {
        "art_direction_id": {
          "anyOf": [
            {
              "minimum": 1,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Art Direction Id"
        },
        "ask_at_run_time": {
          "default": false,
          "title": "Ask At Run Time",
          "type": "boolean"
        }
      },
      "title": "ArtDirectionInputConfig",
      "type": "object"
    },
    "ArtDirectionInputNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "type": {
          "const": "input.art_direction",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "$ref": "#/$defs/ArtDirectionInputConfig"
        }
      },
      "required": [
        "id",
        "type",
        "config"
      ],
      "title": "ArtDirectionInputNodeInput",
      "type": "object"
    },
    "AvatarInputConfig": {
      "additionalProperties": false,
      "properties": {
        "avatar_id": {
          "anyOf": [
            {
              "minimum": 1,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Avatar Id"
        },
        "ask_at_run_time": {
          "default": false,
          "title": "Ask At Run Time",
          "type": "boolean"
        }
      },
      "title": "AvatarInputConfig",
      "type": "object"
    },
    "AvatarInputNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "type": {
          "const": "input.avatar",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "$ref": "#/$defs/AvatarInputConfig"
        }
      },
      "required": [
        "id",
        "type",
        "config"
      ],
      "title": "AvatarInputNodeInput",
      "type": "object"
    },
    "BranchNodeConfig": {
      "additionalProperties": false,
      "properties": {
        "condition_type": {
          "const": "qa_decision",
          "title": "Condition Type",
          "type": "string"
        },
        "cases": {
          "additionalProperties": {
            "enum": [
              "accepted",
              "rejected",
              "error"
            ],
            "type": "string"
          },
          "minProperties": 1,
          "propertyNames": {
            "enum": [
              "accepted",
              "rejected",
              "error"
            ]
          },
          "title": "Cases",
          "type": "object"
        }
      },
      "required": [
        "condition_type",
        "cases"
      ],
      "title": "BranchNodeConfig",
      "type": "object"
    },
    "BranchNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "readiness": {
          "$ref": "#/$defs/ReadinessInput"
        },
        "infrastructure_retry": {
          "$ref": "#/$defs/InfrastructureRetryInput"
        },
        "type": {
          "const": "branch",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "$ref": "#/$defs/BranchNodeConfig"
        }
      },
      "required": [
        "id",
        "readiness",
        "infrastructure_retry",
        "type",
        "config"
      ],
      "title": "BranchNodeInput",
      "type": "object"
    },
    "ClothingInputConfig": {
      "additionalProperties": false,
      "properties": {
        "clothing_item_id": {
          "anyOf": [
            {
              "minimum": 1,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Clothing Item Id"
        },
        "ask_at_run_time": {
          "default": false,
          "title": "Ask At Run Time",
          "type": "boolean"
        }
      },
      "title": "ClothingInputConfig",
      "type": "object"
    },
    "ClothingInputNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "type": {
          "const": "input.clothing",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "$ref": "#/$defs/ClothingInputConfig"
        }
      },
      "required": [
        "id",
        "type",
        "config"
      ],
      "title": "ClothingInputNodeInput",
      "type": "object"
    },
    "DeliverTagDestination": {
      "additionalProperties": false,
      "properties": {
        "type": {
          "const": "tag",
          "title": "Type",
          "type": "string"
        },
        "tag_ids": {
          "items": {
            "type": "integer"
          },
          "maxItems": 50,
          "minItems": 1,
          "title": "Tag Ids",
          "type": "array"
        }
      },
      "required": [
        "type",
        "tag_ids"
      ],
      "title": "DeliverTagDestination",
      "type": "object"
    },
    "DeliverWebhookDestination": {
      "additionalProperties": false,
      "properties": {
        "type": {
          "const": "webhook",
          "title": "Type",
          "type": "string"
        },
        "webhook_id": {
          "format": "uuid",
          "title": "Webhook Id",
          "type": "string"
        },
        "event_type": {
          "pattern": "^workflow\\.[a-z0-9_.-]+$",
          "title": "Event Type",
          "type": "string"
        }
      },
      "required": [
        "type",
        "webhook_id",
        "event_type"
      ],
      "title": "DeliverWebhookDestination",
      "type": "object"
    },
    "EdgeBindingInput": {
      "additionalProperties": false,
      "properties": {
        "mode": {
          "enum": [
            "single",
            "collect"
          ],
          "title": "Mode",
          "type": "string"
        },
        "required": {
          "title": "Required",
          "type": "boolean"
        },
        "role": {
          "anyOf": [
            {
              "enum": [
                "background",
                "style"
              ],
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Role"
        }
      },
      "required": [
        "mode",
        "required"
      ],
      "title": "EdgeBindingInput",
      "type": "object"
    },
    "EdgeEndpointInput": {
      "additionalProperties": false,
      "properties": {
        "node_id": {
          "format": "uuid",
          "title": "Node Id",
          "type": "string"
        },
        "port": {
          "maxLength": 100,
          "minLength": 1,
          "title": "Port",
          "type": "string"
        }
      },
      "required": [
        "node_id",
        "port"
      ],
      "title": "EdgeEndpointInput",
      "type": "object"
    },
    "GenerateNodeConfig": {
      "additionalProperties": false,
      "properties": {
        "variant": {
          "enum": [
            "generate",
            "edit",
            "text_to_image"
          ],
          "title": "Variant",
          "type": "string"
        },
        "model_slug": {
          "maxLength": 100,
          "minLength": 1,
          "title": "Model Slug",
          "type": "string"
        },
        "parameters": {
          "additionalProperties": true,
          "title": "Parameters",
          "type": "object"
        }
      },
      "required": [
        "variant",
        "model_slug",
        "parameters"
      ],
      "title": "GenerateNodeConfig",
      "type": "object"
    },
    "GenerateNodeConfigV1_2": {
      "additionalProperties": false,
      "properties": {
        "variant": {
          "enum": [
            "generate",
            "edit",
            "text_to_image",
            "video"
          ],
          "title": "Variant",
          "type": "string"
        },
        "model_slug": {
          "maxLength": 100,
          "minLength": 1,
          "title": "Model Slug",
          "type": "string"
        },
        "parameters": {
          "additionalProperties": true,
          "title": "Parameters",
          "type": "object"
        }
      },
      "required": [
        "variant",
        "model_slug",
        "parameters"
      ],
      "title": "GenerateNodeConfigV1_2",
      "type": "object"
    },
    "GenerateNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "readiness": {
          "$ref": "#/$defs/ReadinessInput"
        },
        "infrastructure_retry": {
          "$ref": "#/$defs/InfrastructureRetryInput"
        },
        "type": {
          "const": "generate",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "anyOf": [
            {
              "$ref": "#/$defs/GenerateNodeConfig"
            },
            {
              "$ref": "#/$defs/GenerateNodeConfigV1_2"
            }
          ],
          "title": "Config"
        }
      },
      "required": [
        "id",
        "readiness",
        "infrastructure_retry",
        "type",
        "config"
      ],
      "title": "GenerateNodeInput",
      "type": "object"
    },
    "ImageInputConfig": {
      "additionalProperties": false,
      "properties": {
        "generation_result_id": {
          "anyOf": [
            {
              "minimum": 1,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Generation Result Id"
        },
        "ask_at_run_time": {
          "default": false,
          "title": "Ask At Run Time",
          "type": "boolean"
        }
      },
      "title": "ImageInputConfig",
      "type": "object"
    },
    "ImageInputNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "type": {
          "const": "input.image",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "$ref": "#/$defs/ImageInputConfig"
        }
      },
      "required": [
        "id",
        "type",
        "config"
      ],
      "title": "ImageInputNodeInput",
      "type": "object"
    },
    "InfrastructureRetryInput": {
      "additionalProperties": false,
      "properties": {
        "max_attempts": {
          "maximum": 20,
          "minimum": 1,
          "title": "Max Attempts",
          "type": "integer"
        },
        "initial_backoff_seconds": {
          "maximum": 86400,
          "minimum": 0,
          "title": "Initial Backoff Seconds",
          "type": "integer"
        },
        "max_backoff_seconds": {
          "maximum": 86400,
          "minimum": 0,
          "title": "Max Backoff Seconds",
          "type": "integer"
        }
      },
      "required": [
        "max_attempts",
        "initial_backoff_seconds",
        "max_backoff_seconds"
      ],
      "title": "InfrastructureRetryInput",
      "type": "object"
    },
    "LocationInputConfig": {
      "additionalProperties": false,
      "properties": {
        "location_id": {
          "anyOf": [
            {
              "minimum": 1,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Location Id"
        },
        "ask_at_run_time": {
          "default": false,
          "title": "Ask At Run Time",
          "type": "boolean"
        }
      },
      "title": "LocationInputConfig",
      "type": "object"
    },
    "LocationInputNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "type": {
          "const": "input.location",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "$ref": "#/$defs/LocationInputConfig"
        }
      },
      "required": [
        "id",
        "type",
        "config"
      ],
      "title": "LocationInputNodeInput",
      "type": "object"
    },
    "NotifyNodeConfig": {
      "additionalProperties": false,
      "properties": {
        "webhook_id": {
          "format": "uuid",
          "title": "Webhook Id",
          "type": "string"
        },
        "event_type": {
          "pattern": "^workflow\\.[a-z0-9_.-]+$",
          "title": "Event Type",
          "type": "string"
        }
      },
      "required": [
        "webhook_id",
        "event_type"
      ],
      "title": "NotifyNodeConfig",
      "type": "object"
    },
    "NotifyNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "readiness": {
          "$ref": "#/$defs/ReadinessInput"
        },
        "infrastructure_retry": {
          "$ref": "#/$defs/InfrastructureRetryInput"
        },
        "type": {
          "const": "notify",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "$ref": "#/$defs/NotifyNodeConfig"
        }
      },
      "required": [
        "id",
        "readiness",
        "infrastructure_retry",
        "type",
        "config"
      ],
      "title": "NotifyNodeInput",
      "type": "object"
    },
    "OutputNodeConfig": {
      "additionalProperties": false,
      "properties": {
        "projection": {
          "items": {
            "enum": [
              "artifacts",
              "qa",
              "billing",
              "provenance"
            ],
            "type": "string"
          },
          "minItems": 1,
          "title": "Projection",
          "type": "array"
        }
      },
      "required": [
        "projection"
      ],
      "title": "OutputNodeConfig",
      "type": "object"
    },
    "OutputNodeConfigV1_2": {
      "additionalProperties": false,
      "properties": {
        "projection": {
          "items": {
            "enum": [
              "artifacts",
              "qa",
              "billing",
              "provenance"
            ],
            "type": "string"
          },
          "minItems": 1,
          "title": "Projection",
          "type": "array"
        }
      },
      "title": "OutputNodeConfigV1_2",
      "type": "object"
    },
    "OutputNodeConfigV1_3": {
      "additionalProperties": false,
      "properties": {
        "destinations": {
          "items": {
            "discriminator": {
              "mapping": {
                "tag": "#/$defs/DeliverTagDestination",
                "webhook": "#/$defs/DeliverWebhookDestination"
              },
              "propertyName": "type"
            },
            "oneOf": [
              {
                "additionalProperties": false,
                "properties": {
                  "type": {
                    "const": "tag",
                    "title": "Type",
                    "type": "string"
                  },
                  "tag_ids": {
                    "items": {
                      "type": "integer"
                    },
                    "maxItems": 50,
                    "minItems": 1,
                    "title": "Tag Ids",
                    "type": "array"
                  }
                },
                "required": [
                  "type",
                  "tag_ids"
                ],
                "title": "DeliverTagDestination",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "type": {
                    "const": "webhook",
                    "title": "Type",
                    "type": "string"
                  },
                  "webhook_id": {
                    "format": "uuid",
                    "title": "Webhook Id",
                    "type": "string"
                  },
                  "event_type": {
                    "pattern": "^workflow\\.[a-z0-9_.-]+$",
                    "title": "Event Type",
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "webhook_id",
                  "event_type"
                ],
                "title": "DeliverWebhookDestination",
                "type": "object"
              }
            ],
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "tag",
                  "webhook"
                ]
              },
              "tag_ids": {
                "items": {
                  "type": "integer"
                },
                "maxItems": 50,
                "minItems": 1,
                "title": "Tag Ids",
                "type": "array"
              },
              "webhook_id": {
                "format": "uuid",
                "title": "Webhook Id",
                "type": "string"
              },
              "event_type": {
                "pattern": "^workflow\\.[a-z0-9_.-]+$",
                "title": "Event Type",
                "type": "string"
              }
            }
          },
          "maxItems": 20,
          "title": "Destinations",
          "type": "array"
        },
        "projection": {
          "anyOf": [
            {
              "items": {
                "enum": [
                  "artifacts",
                  "qa",
                  "billing",
                  "provenance"
                ],
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Projection"
        }
      },
      "title": "OutputNodeConfigV1_3",
      "type": "object"
    },
    "OutputNodeConfigV1_4": {
      "additionalProperties": false,
      "properties": {
        "destinations": {
          "items": {
            "discriminator": {
              "mapping": {
                "tag": "#/$defs/DeliverTagDestination",
                "webhook": "#/$defs/DeliverWebhookDestination"
              },
              "propertyName": "type"
            },
            "oneOf": [
              {
                "additionalProperties": false,
                "properties": {
                  "type": {
                    "const": "tag",
                    "title": "Type",
                    "type": "string"
                  },
                  "tag_ids": {
                    "items": {
                      "type": "integer"
                    },
                    "maxItems": 50,
                    "minItems": 1,
                    "title": "Tag Ids",
                    "type": "array"
                  }
                },
                "required": [
                  "type",
                  "tag_ids"
                ],
                "title": "DeliverTagDestination",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "type": {
                    "const": "webhook",
                    "title": "Type",
                    "type": "string"
                  },
                  "webhook_id": {
                    "format": "uuid",
                    "title": "Webhook Id",
                    "type": "string"
                  },
                  "event_type": {
                    "pattern": "^workflow\\.[a-z0-9_.-]+$",
                    "title": "Event Type",
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "webhook_id",
                  "event_type"
                ],
                "title": "DeliverWebhookDestination",
                "type": "object"
              }
            ],
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "tag",
                  "webhook"
                ]
              },
              "tag_ids": {
                "items": {
                  "type": "integer"
                },
                "maxItems": 50,
                "minItems": 1,
                "title": "Tag Ids",
                "type": "array"
              },
              "webhook_id": {
                "format": "uuid",
                "title": "Webhook Id",
                "type": "string"
              },
              "event_type": {
                "pattern": "^workflow\\.[a-z0-9_.-]+$",
                "title": "Event Type",
                "type": "string"
              }
            }
          },
          "maxItems": 20,
          "title": "Destinations",
          "type": "array"
        }
      },
      "title": "OutputNodeConfigV1_4",
      "type": "object"
    },
    "OutputNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "readiness": {
          "$ref": "#/$defs/ReadinessInput"
        },
        "infrastructure_retry": {
          "$ref": "#/$defs/InfrastructureRetryInput"
        },
        "type": {
          "const": "output",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "anyOf": [
            {
              "$ref": "#/$defs/OutputNodeConfig"
            },
            {
              "$ref": "#/$defs/OutputNodeConfigV1_2"
            },
            {
              "$ref": "#/$defs/OutputNodeConfigV1_3"
            },
            {
              "$ref": "#/$defs/OutputNodeConfigV1_4"
            }
          ],
          "title": "Config"
        }
      },
      "required": [
        "id",
        "readiness",
        "infrastructure_retry",
        "type",
        "config"
      ],
      "title": "OutputNodeInput",
      "type": "object"
    },
    "PromptInputConfig": {
      "additionalProperties": false,
      "properties": {
        "text": {
          "anyOf": [
            {
              "maxLength": 10000,
              "minLength": 1,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Text"
        },
        "ask_at_run_time": {
          "default": false,
          "title": "Ask At Run Time",
          "type": "boolean"
        }
      },
      "title": "PromptInputConfig",
      "type": "object"
    },
    "PromptInputNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "type": {
          "const": "input.prompt",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "$ref": "#/$defs/PromptInputConfig"
        }
      },
      "required": [
        "id",
        "type",
        "config"
      ],
      "title": "PromptInputNodeInput",
      "type": "object"
    },
    "QaGateNodeConfig": {
      "additionalProperties": false,
      "properties": {
        "policy": {
          "maxLength": 100,
          "minLength": 1,
          "title": "Policy",
          "type": "string"
        },
        "max_content_retries": {
          "maximum": 20,
          "minimum": 0,
          "title": "Max Content Retries",
          "type": "integer"
        }
      },
      "required": [
        "policy",
        "max_content_retries"
      ],
      "title": "QaGateNodeConfig",
      "type": "object"
    },
    "QaGateNodeConfigV1_2": {
      "additionalProperties": false,
      "properties": {
        "policy": {
          "maxLength": 100,
          "minLength": 1,
          "title": "Policy",
          "type": "string"
        },
        "max_content_retries": {
          "maximum": 20,
          "minimum": 0,
          "title": "Max Content Retries",
          "type": "integer"
        },
        "graph_retry": {
          "anyOf": [
            {
              "$ref": "#/$defs/QaGraphRetryConfig"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "required": [
        "policy",
        "max_content_retries"
      ],
      "title": "QaGateNodeConfigV1_2",
      "type": "object"
    },
    "QaGateNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "readiness": {
          "$ref": "#/$defs/ReadinessInput"
        },
        "infrastructure_retry": {
          "$ref": "#/$defs/InfrastructureRetryInput"
        },
        "type": {
          "const": "qa_gate",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "anyOf": [
            {
              "$ref": "#/$defs/QaGateNodeConfig"
            },
            {
              "$ref": "#/$defs/QaGateNodeConfigV1_2"
            }
          ],
          "title": "Config"
        }
      },
      "required": [
        "id",
        "readiness",
        "infrastructure_retry",
        "type",
        "config"
      ],
      "title": "QaGateNodeInput",
      "type": "object"
    },
    "QaGraphRetryConfig": {
      "additionalProperties": false,
      "properties": {
        "retry_from_node_id": {
          "format": "uuid",
          "title": "Retry From Node Id",
          "type": "string"
        },
        "max_retries": {
          "maximum": 20,
          "minimum": 1,
          "title": "Max Retries",
          "type": "integer"
        }
      },
      "required": [
        "retry_from_node_id",
        "max_retries"
      ],
      "title": "QaGraphRetryConfig",
      "type": "object"
    },
    "ReadinessInput": {
      "additionalProperties": false,
      "properties": {
        "mode": {
          "enum": [
            "all_required",
            "all_terminal"
          ],
          "title": "Mode",
          "type": "string"
        }
      },
      "required": [
        "mode"
      ],
      "title": "ReadinessInput",
      "type": "object"
    },
    "TriggerNodeConfig": {
      "additionalProperties": false,
      "properties": {
        "source": {
          "pattern": "^[a-z][a-z0-9_-]*(\\.[a-z][a-z0-9_-]*)+$",
          "title": "Source",
          "type": "string"
        },
        "settings": {
          "additionalProperties": true,
          "title": "Settings",
          "type": "object"
        }
      },
      "required": [
        "source",
        "settings"
      ],
      "title": "TriggerNodeConfig",
      "type": "object"
    },
    "TriggerNodeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "type": {
          "const": "trigger",
          "title": "Type",
          "type": "string"
        },
        "config": {
          "$ref": "#/$defs/TriggerNodeConfig"
        }
      },
      "required": [
        "id",
        "type",
        "config"
      ],
      "title": "TriggerNodeInput",
      "type": "object"
    },
    "WorkflowEdgeInput": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "format": "uuid",
          "title": "Id",
          "type": "string"
        },
        "source": {
          "$ref": "#/$defs/EdgeEndpointInput"
        },
        "target": {
          "$ref": "#/$defs/EdgeEndpointInput"
        },
        "binding": {
          "$ref": "#/$defs/EdgeBindingInput"
        }
      },
      "required": [
        "id",
        "source",
        "target",
        "binding"
      ],
      "title": "WorkflowEdgeInput",
      "type": "object"
    },
    "WorkflowFailurePolicy": {
      "enum": [
        "fail_fast",
        "continue_independent"
      ],
      "title": "WorkflowFailurePolicy",
      "type": "string"
    },
    "WorkflowVersionUpdate": {
      "additionalProperties": false,
      "properties": {
        "failure_policy": {
          "$ref": "#/$defs/WorkflowFailurePolicy",
          "default": null
        },
        "result_projection": {
          "default": null,
          "items": {
            "enum": [
              "artifacts",
              "qa",
              "billing",
              "provenance"
            ],
            "type": "string"
          },
          "minItems": 1,
          "title": "Result Projection",
          "type": "array"
        },
        "nodes": {
          "default": null,
          "items": {
            "discriminator": {
              "mapping": {
                "branch": "#/$defs/BranchNodeInput",
                "generate": "#/$defs/GenerateNodeInput",
                "input.ai_model": "#/$defs/AiModelInputNodeInput",
                "input.art_direction": "#/$defs/ArtDirectionInputNodeInput",
                "input.avatar": "#/$defs/AvatarInputNodeInput",
                "input.clothing": "#/$defs/ClothingInputNodeInput",
                "input.image": "#/$defs/ImageInputNodeInput",
                "input.location": "#/$defs/LocationInputNodeInput",
                "input.prompt": "#/$defs/PromptInputNodeInput",
                "notify": "#/$defs/NotifyNodeInput",
                "output": "#/$defs/OutputNodeInput",
                "qa_gate": "#/$defs/QaGateNodeInput",
                "trigger": "#/$defs/TriggerNodeInput"
              },
              "propertyName": "type"
            },
            "oneOf": [
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "type": {
                    "const": "trigger",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "additionalProperties": false,
                    "properties": {
                      "source": {
                        "pattern": "^[a-z][a-z0-9_-]*(\\.[a-z][a-z0-9_-]*)+$",
                        "title": "Source",
                        "type": "string"
                      },
                      "settings": {
                        "additionalProperties": true,
                        "title": "Settings",
                        "type": "object"
                      }
                    },
                    "required": [
                      "source",
                      "settings"
                    ],
                    "title": "TriggerNodeConfig",
                    "type": "object"
                  }
                },
                "required": [
                  "id",
                  "type",
                  "config"
                ],
                "title": "TriggerNodeInput",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "readiness": {
                    "additionalProperties": false,
                    "properties": {
                      "mode": {
                        "enum": [
                          "all_required",
                          "all_terminal"
                        ],
                        "title": "Mode",
                        "type": "string"
                      }
                    },
                    "required": [
                      "mode"
                    ],
                    "title": "ReadinessInput",
                    "type": "object"
                  },
                  "infrastructure_retry": {
                    "additionalProperties": false,
                    "properties": {
                      "max_attempts": {
                        "maximum": 20,
                        "minimum": 1,
                        "title": "Max Attempts",
                        "type": "integer"
                      },
                      "initial_backoff_seconds": {
                        "maximum": 86400,
                        "minimum": 0,
                        "title": "Initial Backoff Seconds",
                        "type": "integer"
                      },
                      "max_backoff_seconds": {
                        "maximum": 86400,
                        "minimum": 0,
                        "title": "Max Backoff Seconds",
                        "type": "integer"
                      }
                    },
                    "required": [
                      "max_attempts",
                      "initial_backoff_seconds",
                      "max_backoff_seconds"
                    ],
                    "title": "InfrastructureRetryInput",
                    "type": "object"
                  },
                  "type": {
                    "const": "generate",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "anyOf": [
                      {
                        "additionalProperties": false,
                        "properties": {
                          "variant": {
                            "enum": [
                              "generate",
                              "edit",
                              "text_to_image"
                            ],
                            "title": "Variant",
                            "type": "string"
                          },
                          "model_slug": {
                            "maxLength": 100,
                            "minLength": 1,
                            "title": "Model Slug",
                            "type": "string"
                          },
                          "parameters": {
                            "additionalProperties": true,
                            "title": "Parameters",
                            "type": "object"
                          }
                        },
                        "required": [
                          "variant",
                          "model_slug",
                          "parameters"
                        ],
                        "title": "GenerateNodeConfig",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "variant": {
                            "enum": [
                              "generate",
                              "edit",
                              "text_to_image",
                              "video"
                            ],
                            "title": "Variant",
                            "type": "string"
                          },
                          "model_slug": {
                            "maxLength": 100,
                            "minLength": 1,
                            "title": "Model Slug",
                            "type": "string"
                          },
                          "parameters": {
                            "additionalProperties": true,
                            "title": "Parameters",
                            "type": "object"
                          }
                        },
                        "required": [
                          "variant",
                          "model_slug",
                          "parameters"
                        ],
                        "title": "GenerateNodeConfigV1_2",
                        "type": "object"
                      }
                    ],
                    "title": "Config"
                  }
                },
                "required": [
                  "id",
                  "readiness",
                  "infrastructure_retry",
                  "type",
                  "config"
                ],
                "title": "GenerateNodeInput",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "readiness": {
                    "additionalProperties": false,
                    "properties": {
                      "mode": {
                        "enum": [
                          "all_required",
                          "all_terminal"
                        ],
                        "title": "Mode",
                        "type": "string"
                      }
                    },
                    "required": [
                      "mode"
                    ],
                    "title": "ReadinessInput",
                    "type": "object"
                  },
                  "infrastructure_retry": {
                    "additionalProperties": false,
                    "properties": {
                      "max_attempts": {
                        "maximum": 20,
                        "minimum": 1,
                        "title": "Max Attempts",
                        "type": "integer"
                      },
                      "initial_backoff_seconds": {
                        "maximum": 86400,
                        "minimum": 0,
                        "title": "Initial Backoff Seconds",
                        "type": "integer"
                      },
                      "max_backoff_seconds": {
                        "maximum": 86400,
                        "minimum": 0,
                        "title": "Max Backoff Seconds",
                        "type": "integer"
                      }
                    },
                    "required": [
                      "max_attempts",
                      "initial_backoff_seconds",
                      "max_backoff_seconds"
                    ],
                    "title": "InfrastructureRetryInput",
                    "type": "object"
                  },
                  "type": {
                    "const": "qa_gate",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "anyOf": [
                      {
                        "additionalProperties": false,
                        "properties": {
                          "policy": {
                            "maxLength": 100,
                            "minLength": 1,
                            "title": "Policy",
                            "type": "string"
                          },
                          "max_content_retries": {
                            "maximum": 20,
                            "minimum": 0,
                            "title": "Max Content Retries",
                            "type": "integer"
                          }
                        },
                        "required": [
                          "policy",
                          "max_content_retries"
                        ],
                        "title": "QaGateNodeConfig",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "policy": {
                            "maxLength": 100,
                            "minLength": 1,
                            "title": "Policy",
                            "type": "string"
                          },
                          "max_content_retries": {
                            "maximum": 20,
                            "minimum": 0,
                            "title": "Max Content Retries",
                            "type": "integer"
                          },
                          "graph_retry": {
                            "anyOf": [
                              {
                                "additionalProperties": false,
                                "properties": {
                                  "retry_from_node_id": {
                                    "format": "uuid",
                                    "title": "Retry From Node Id",
                                    "type": "string"
                                  },
                                  "max_retries": {
                                    "maximum": 20,
                                    "minimum": 1,
                                    "title": "Max Retries",
                                    "type": "integer"
                                  }
                                },
                                "required": [
                                  "retry_from_node_id",
                                  "max_retries"
                                ],
                                "title": "QaGraphRetryConfig",
                                "type": "object"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "default": null
                          }
                        },
                        "required": [
                          "policy",
                          "max_content_retries"
                        ],
                        "title": "QaGateNodeConfigV1_2",
                        "type": "object"
                      }
                    ],
                    "title": "Config"
                  }
                },
                "required": [
                  "id",
                  "readiness",
                  "infrastructure_retry",
                  "type",
                  "config"
                ],
                "title": "QaGateNodeInput",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "readiness": {
                    "additionalProperties": false,
                    "properties": {
                      "mode": {
                        "enum": [
                          "all_required",
                          "all_terminal"
                        ],
                        "title": "Mode",
                        "type": "string"
                      }
                    },
                    "required": [
                      "mode"
                    ],
                    "title": "ReadinessInput",
                    "type": "object"
                  },
                  "infrastructure_retry": {
                    "additionalProperties": false,
                    "properties": {
                      "max_attempts": {
                        "maximum": 20,
                        "minimum": 1,
                        "title": "Max Attempts",
                        "type": "integer"
                      },
                      "initial_backoff_seconds": {
                        "maximum": 86400,
                        "minimum": 0,
                        "title": "Initial Backoff Seconds",
                        "type": "integer"
                      },
                      "max_backoff_seconds": {
                        "maximum": 86400,
                        "minimum": 0,
                        "title": "Max Backoff Seconds",
                        "type": "integer"
                      }
                    },
                    "required": [
                      "max_attempts",
                      "initial_backoff_seconds",
                      "max_backoff_seconds"
                    ],
                    "title": "InfrastructureRetryInput",
                    "type": "object"
                  },
                  "type": {
                    "const": "branch",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "additionalProperties": false,
                    "properties": {
                      "condition_type": {
                        "const": "qa_decision",
                        "title": "Condition Type",
                        "type": "string"
                      },
                      "cases": {
                        "additionalProperties": {
                          "enum": [
                            "accepted",
                            "rejected",
                            "error"
                          ],
                          "type": "string"
                        },
                        "minProperties": 1,
                        "propertyNames": {
                          "enum": [
                            "accepted",
                            "rejected",
                            "error"
                          ]
                        },
                        "title": "Cases",
                        "type": "object"
                      }
                    },
                    "required": [
                      "condition_type",
                      "cases"
                    ],
                    "title": "BranchNodeConfig",
                    "type": "object"
                  }
                },
                "required": [
                  "id",
                  "readiness",
                  "infrastructure_retry",
                  "type",
                  "config"
                ],
                "title": "BranchNodeInput",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "readiness": {
                    "additionalProperties": false,
                    "properties": {
                      "mode": {
                        "enum": [
                          "all_required",
                          "all_terminal"
                        ],
                        "title": "Mode",
                        "type": "string"
                      }
                    },
                    "required": [
                      "mode"
                    ],
                    "title": "ReadinessInput",
                    "type": "object"
                  },
                  "infrastructure_retry": {
                    "additionalProperties": false,
                    "properties": {
                      "max_attempts": {
                        "maximum": 20,
                        "minimum": 1,
                        "title": "Max Attempts",
                        "type": "integer"
                      },
                      "initial_backoff_seconds": {
                        "maximum": 86400,
                        "minimum": 0,
                        "title": "Initial Backoff Seconds",
                        "type": "integer"
                      },
                      "max_backoff_seconds": {
                        "maximum": 86400,
                        "minimum": 0,
                        "title": "Max Backoff Seconds",
                        "type": "integer"
                      }
                    },
                    "required": [
                      "max_attempts",
                      "initial_backoff_seconds",
                      "max_backoff_seconds"
                    ],
                    "title": "InfrastructureRetryInput",
                    "type": "object"
                  },
                  "type": {
                    "const": "output",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "anyOf": [
                      {
                        "additionalProperties": false,
                        "properties": {
                          "projection": {
                            "items": {
                              "enum": [
                                "artifacts",
                                "qa",
                                "billing",
                                "provenance"
                              ],
                              "type": "string"
                            },
                            "minItems": 1,
                            "title": "Projection",
                            "type": "array"
                          }
                        },
                        "required": [
                          "projection"
                        ],
                        "title": "OutputNodeConfig",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "projection": {
                            "items": {
                              "enum": [
                                "artifacts",
                                "qa",
                                "billing",
                                "provenance"
                              ],
                              "type": "string"
                            },
                            "minItems": 1,
                            "title": "Projection",
                            "type": "array"
                          }
                        },
                        "title": "OutputNodeConfigV1_2",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "destinations": {
                            "items": {
                              "discriminator": {
                                "mapping": {
                                  "tag": "#/$defs/DeliverTagDestination",
                                  "webhook": "#/$defs/DeliverWebhookDestination"
                                },
                                "propertyName": "type"
                              },
                              "oneOf": [
                                {
                                  "additionalProperties": false,
                                  "properties": {
                                    "type": {
                                      "const": "tag",
                                      "title": "Type",
                                      "type": "string"
                                    },
                                    "tag_ids": {
                                      "items": {
                                        "type": "integer"
                                      },
                                      "maxItems": 50,
                                      "minItems": 1,
                                      "title": "Tag Ids",
                                      "type": "array"
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "tag_ids"
                                  ],
                                  "title": "DeliverTagDestination",
                                  "type": "object"
                                },
                                {
                                  "additionalProperties": false,
                                  "properties": {
                                    "type": {
                                      "const": "webhook",
                                      "title": "Type",
                                      "type": "string"
                                    },
                                    "webhook_id": {
                                      "format": "uuid",
                                      "title": "Webhook Id",
                                      "type": "string"
                                    },
                                    "event_type": {
                                      "pattern": "^workflow\\.[a-z0-9_.-]+$",
                                      "title": "Event Type",
                                      "type": "string"
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "webhook_id",
                                    "event_type"
                                  ],
                                  "title": "DeliverWebhookDestination",
                                  "type": "object"
                                }
                              ],
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "tag",
                                    "webhook"
                                  ]
                                },
                                "tag_ids": {
                                  "items": {
                                    "type": "integer"
                                  },
                                  "maxItems": 50,
                                  "minItems": 1,
                                  "title": "Tag Ids",
                                  "type": "array"
                                },
                                "webhook_id": {
                                  "format": "uuid",
                                  "title": "Webhook Id",
                                  "type": "string"
                                },
                                "event_type": {
                                  "pattern": "^workflow\\.[a-z0-9_.-]+$",
                                  "title": "Event Type",
                                  "type": "string"
                                }
                              }
                            },
                            "maxItems": 20,
                            "title": "Destinations",
                            "type": "array"
                          },
                          "projection": {
                            "anyOf": [
                              {
                                "items": {
                                  "enum": [
                                    "artifacts",
                                    "qa",
                                    "billing",
                                    "provenance"
                                  ],
                                  "type": "string"
                                },
                                "type": "array"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "default": null,
                            "title": "Projection"
                          }
                        },
                        "title": "OutputNodeConfigV1_3",
                        "type": "object"
                      },
                      {
                        "additionalProperties": false,
                        "properties": {
                          "destinations": {
                            "items": {
                              "discriminator": {
                                "mapping": {
                                  "tag": "#/$defs/DeliverTagDestination",
                                  "webhook": "#/$defs/DeliverWebhookDestination"
                                },
                                "propertyName": "type"
                              },
                              "oneOf": [
                                {
                                  "additionalProperties": false,
                                  "properties": {
                                    "type": {
                                      "const": "tag",
                                      "title": "Type",
                                      "type": "string"
                                    },
                                    "tag_ids": {
                                      "items": {
                                        "type": "integer"
                                      },
                                      "maxItems": 50,
                                      "minItems": 1,
                                      "title": "Tag Ids",
                                      "type": "array"
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "tag_ids"
                                  ],
                                  "title": "DeliverTagDestination",
                                  "type": "object"
                                },
                                {
                                  "additionalProperties": false,
                                  "properties": {
                                    "type": {
                                      "const": "webhook",
                                      "title": "Type",
                                      "type": "string"
                                    },
                                    "webhook_id": {
                                      "format": "uuid",
                                      "title": "Webhook Id",
                                      "type": "string"
                                    },
                                    "event_type": {
                                      "pattern": "^workflow\\.[a-z0-9_.-]+$",
                                      "title": "Event Type",
                                      "type": "string"
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "webhook_id",
                                    "event_type"
                                  ],
                                  "title": "DeliverWebhookDestination",
                                  "type": "object"
                                }
                              ],
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "tag",
                                    "webhook"
                                  ]
                                },
                                "tag_ids": {
                                  "items": {
                                    "type": "integer"
                                  },
                                  "maxItems": 50,
                                  "minItems": 1,
                                  "title": "Tag Ids",
                                  "type": "array"
                                },
                                "webhook_id": {
                                  "format": "uuid",
                                  "title": "Webhook Id",
                                  "type": "string"
                                },
                                "event_type": {
                                  "pattern": "^workflow\\.[a-z0-9_.-]+$",
                                  "title": "Event Type",
                                  "type": "string"
                                }
                              }
                            },
                            "maxItems": 20,
                            "title": "Destinations",
                            "type": "array"
                          }
                        },
                        "title": "OutputNodeConfigV1_4",
                        "type": "object"
                      }
                    ],
                    "title": "Config"
                  }
                },
                "required": [
                  "id",
                  "readiness",
                  "infrastructure_retry",
                  "type",
                  "config"
                ],
                "title": "OutputNodeInput",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "readiness": {
                    "additionalProperties": false,
                    "properties": {
                      "mode": {
                        "enum": [
                          "all_required",
                          "all_terminal"
                        ],
                        "title": "Mode",
                        "type": "string"
                      }
                    },
                    "required": [
                      "mode"
                    ],
                    "title": "ReadinessInput",
                    "type": "object"
                  },
                  "infrastructure_retry": {
                    "additionalProperties": false,
                    "properties": {
                      "max_attempts": {
                        "maximum": 20,
                        "minimum": 1,
                        "title": "Max Attempts",
                        "type": "integer"
                      },
                      "initial_backoff_seconds": {
                        "maximum": 86400,
                        "minimum": 0,
                        "title": "Initial Backoff Seconds",
                        "type": "integer"
                      },
                      "max_backoff_seconds": {
                        "maximum": 86400,
                        "minimum": 0,
                        "title": "Max Backoff Seconds",
                        "type": "integer"
                      }
                    },
                    "required": [
                      "max_attempts",
                      "initial_backoff_seconds",
                      "max_backoff_seconds"
                    ],
                    "title": "InfrastructureRetryInput",
                    "type": "object"
                  },
                  "type": {
                    "const": "notify",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "additionalProperties": false,
                    "properties": {
                      "webhook_id": {
                        "format": "uuid",
                        "title": "Webhook Id",
                        "type": "string"
                      },
                      "event_type": {
                        "pattern": "^workflow\\.[a-z0-9_.-]+$",
                        "title": "Event Type",
                        "type": "string"
                      }
                    },
                    "required": [
                      "webhook_id",
                      "event_type"
                    ],
                    "title": "NotifyNodeConfig",
                    "type": "object"
                  }
                },
                "required": [
                  "id",
                  "readiness",
                  "infrastructure_retry",
                  "type",
                  "config"
                ],
                "title": "NotifyNodeInput",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "type": {
                    "const": "input.avatar",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "additionalProperties": false,
                    "properties": {
                      "avatar_id": {
                        "anyOf": [
                          {
                            "minimum": 1,
                            "type": "integer"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "default": null,
                        "title": "Avatar Id"
                      },
                      "ask_at_run_time": {
                        "default": false,
                        "title": "Ask At Run Time",
                        "type": "boolean"
                      }
                    },
                    "title": "AvatarInputConfig",
                    "type": "object"
                  }
                },
                "required": [
                  "id",
                  "type",
                  "config"
                ],
                "title": "AvatarInputNodeInput",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "type": {
                    "const": "input.clothing",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "additionalProperties": false,
                    "properties": {
                      "clothing_item_id": {
                        "anyOf": [
                          {
                            "minimum": 1,
                            "type": "integer"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "default": null,
                        "title": "Clothing Item Id"
                      },
                      "ask_at_run_time": {
                        "default": false,
                        "title": "Ask At Run Time",
                        "type": "boolean"
                      }
                    },
                    "title": "ClothingInputConfig",
                    "type": "object"
                  }
                },
                "required": [
                  "id",
                  "type",
                  "config"
                ],
                "title": "ClothingInputNodeInput",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "type": {
                    "const": "input.location",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "additionalProperties": false,
                    "properties": {
                      "location_id": {
                        "anyOf": [
                          {
                            "minimum": 1,
                            "type": "integer"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "default": null,
                        "title": "Location Id"
                      },
                      "ask_at_run_time": {
                        "default": false,
                        "title": "Ask At Run Time",
                        "type": "boolean"
                      }
                    },
                    "title": "LocationInputConfig",
                    "type": "object"
                  }
                },
                "required": [
                  "id",
                  "type",
                  "config"
                ],
                "title": "LocationInputNodeInput",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "type": {
                    "const": "input.art_direction",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "additionalProperties": false,
                    "properties": {
                      "art_direction_id": {
                        "anyOf": [
                          {
                            "minimum": 1,
                            "type": "integer"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "default": null,
                        "title": "Art Direction Id"
                      },
                      "ask_at_run_time": {
                        "default": false,
                        "title": "Ask At Run Time",
                        "type": "boolean"
                      }
                    },
                    "title": "ArtDirectionInputConfig",
                    "type": "object"
                  }
                },
                "required": [
                  "id",
                  "type",
                  "config"
                ],
                "title": "ArtDirectionInputNodeInput",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "type": {
                    "const": "input.prompt",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "additionalProperties": false,
                    "properties": {
                      "text": {
                        "anyOf": [
                          {
                            "maxLength": 10000,
                            "minLength": 1,
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "default": null,
                        "title": "Text"
                      },
                      "ask_at_run_time": {
                        "default": false,
                        "title": "Ask At Run Time",
                        "type": "boolean"
                      }
                    },
                    "title": "PromptInputConfig",
                    "type": "object"
                  }
                },
                "required": [
                  "id",
                  "type",
                  "config"
                ],
                "title": "PromptInputNodeInput",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "type": {
                    "const": "input.image",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "additionalProperties": false,
                    "properties": {
                      "generation_result_id": {
                        "anyOf": [
                          {
                            "minimum": 1,
                            "type": "integer"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "default": null,
                        "title": "Generation Result Id"
                      },
                      "ask_at_run_time": {
                        "default": false,
                        "title": "Ask At Run Time",
                        "type": "boolean"
                      }
                    },
                    "title": "ImageInputConfig",
                    "type": "object"
                  }
                },
                "required": [
                  "id",
                  "type",
                  "config"
                ],
                "title": "ImageInputNodeInput",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "properties": {
                  "id": {
                    "format": "uuid",
                    "title": "Id",
                    "type": "string"
                  },
                  "type": {
                    "const": "input.ai_model",
                    "title": "Type",
                    "type": "string"
                  },
                  "config": {
                    "additionalProperties": false,
                    "properties": {
                      "model_slug": {
                        "anyOf": [
                          {
                            "maxLength": 100,
                            "minLength": 1,
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "default": null,
                        "title": "Model Slug"
                      }
                    },
                    "title": "AiModelInputConfig",
                    "type": "object"
                  }
                },
                "required": [
                  "id",
                  "type",
                  "config"
                ],
                "title": "AiModelInputNodeInput",
                "type": "object"
              }
            ],
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "trigger",
                  "generate",
                  "qa_gate",
                  "branch",
                  "output",
                  "notify",
                  "input.avatar",
                  "input.clothing",
                  "input.location",
                  "input.art_direction",
                  "input.prompt",
                  "input.image",
                  "input.ai_model"
                ]
              },
              "id": {
                "format": "uuid",
                "title": "Id",
                "type": "string"
              },
              "config": {
                "additionalProperties": false,
                "properties": {
                  "source": {
                    "pattern": "^[a-z][a-z0-9_-]*(\\.[a-z][a-z0-9_-]*)+$",
                    "title": "Source",
                    "type": "string"
                  },
                  "settings": {
                    "additionalProperties": true,
                    "title": "Settings",
                    "type": "object"
                  }
                },
                "required": [
                  "source",
                  "settings"
                ],
                "title": "TriggerNodeConfig",
                "type": "object"
              },
              "readiness": {
                "additionalProperties": false,
                "properties": {
                  "mode": {
                    "enum": [
                      "all_required",
                      "all_terminal"
                    ],
                    "title": "Mode",
                    "type": "string"
                  }
                },
                "required": [
                  "mode"
                ],
                "title": "ReadinessInput",
                "type": "object"
              },
              "infrastructure_retry": {
                "additionalProperties": false,
                "properties": {
                  "max_attempts": {
                    "maximum": 20,
                    "minimum": 1,
                    "title": "Max Attempts",
                    "type": "integer"
                  },
                  "initial_backoff_seconds": {
                    "maximum": 86400,
                    "minimum": 0,
                    "title": "Initial Backoff Seconds",
                    "type": "integer"
                  },
                  "max_backoff_seconds": {
                    "maximum": 86400,
                    "minimum": 0,
                    "title": "Max Backoff Seconds",
                    "type": "integer"
                  }
                },
                "required": [
                  "max_attempts",
                  "initial_backoff_seconds",
                  "max_backoff_seconds"
                ],
                "title": "InfrastructureRetryInput",
                "type": "object"
              }
            }
          },
          "minItems": 2,
          "title": "Nodes",
          "type": "array"
        },
        "edges": {
          "default": null,
          "items": {
            "$ref": "#/$defs/WorkflowEdgeInput"
          },
          "minItems": 1,
          "title": "Edges",
          "type": "array"
        }
      },
      "title": "WorkflowVersionUpdate",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "title": "UpdateWorkflowVersionInput"
}

publish_production_workflow_version

Validate a draft, freeze it, and make it the version triggers execute. Rejects an invalid graph and returns the reason. See uwear://contracts/production-workflow for typed node configs and worked examples.

Parameters2

workflow_id	string	required	Workflow ID
version_id	string	required	Workflow version ID

Raw schema

{
  "type": "object",
  "properties": {
    "workflow_id": {
      "description": "Workflow ID",
      "format": "uuid",
      "title": "Workflow Id",
      "type": "string"
    },
    "version_id": {
      "description": "Workflow version ID",
      "format": "uuid",
      "title": "Version Id",
      "type": "string"
    }
  },
  "required": [
    "workflow_id",
    "version_id"
  ],
  "additionalProperties": false,
  "title": "WorkflowVersionIdentityInput"
}

start_production_workflow_run

Start one run of a workflow's published version. Requires an idempotency_key: the same key never starts a second run.

Parameters3

workflow_id	string	required	Workflow ID
run	any	optional	Run request with an optional test version, trigger object identity, and payload
idempotency_key	string	required	Unique key that makes retries return the same workflow run

Raw schema

{
  "type": "object",
  "properties": {
    "workflow_id": {
      "description": "Workflow ID",
      "format": "uuid",
      "title": "Workflow Id",
      "type": "string"
    },
    "run": {
      "$ref": "#/$defs/WorkflowRunCreate",
      "description": "Run request with an optional test version, trigger object identity, and payload"
    },
    "idempotency_key": {
      "description": "Unique key that makes retries return the same workflow run",
      "maxLength": 512,
      "minLength": 1,
      "title": "Idempotency Key",
      "type": "string"
    }
  },
  "required": [
    "workflow_id",
    "idempotency_key"
  ],
  "$defs": {
    "WorkflowRunCreate": {
      "additionalProperties": false,
      "properties": {
        "version_id": {
          "anyOf": [
            {
              "format": "uuid",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Version Id"
        },
        "object_type": {
          "default": "workflow_run_request",
          "maxLength": 100,
          "minLength": 1,
          "pattern": "^[a-z][a-z0-9_.-]*$",
          "title": "Object Type",
          "type": "string"
        },
        "object_id": {
          "anyOf": [
            {
              "maxLength": 255,
              "minLength": 1,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Object Id"
        },
        "payload": {
          "additionalProperties": true,
          "title": "Payload",
          "type": "object"
        },
        "slot_bindings": {
          "additionalProperties": true,
          "title": "Slot Bindings",
          "type": "object"
        }
      },
      "title": "WorkflowRunCreate",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "title": "StartWorkflowRunInput"
}

start_production_workflow_run_batch

Start one run per selected object (multi-select / catalog backfill). Each object is admitted independently; failures do not sink the rest.

Parameters3

workflow_id	string	required	Workflow ID
batch	any	required	Batch request: one run per object_id, sharing object_type, payload and call-sheet slot_bindings
idempotency_key	string	required	Base key for the batch; each run derives key:object_id so retries return the same runs

Raw schema

{
  "type": "object",
  "properties": {
    "workflow_id": {
      "description": "Workflow ID",
      "format": "uuid",
      "title": "Workflow Id",
      "type": "string"
    },
    "batch": {
      "$ref": "#/$defs/WorkflowRunBatchCreate",
      "description": "Batch request: one run per object_id, sharing object_type, payload and call-sheet slot_bindings"
    },
    "idempotency_key": {
      "description": "Base key for the batch; each run derives key:object_id so retries return the same runs",
      "maxLength": 255,
      "minLength": 1,
      "title": "Idempotency Key",
      "type": "string"
    }
  },
  "required": [
    "workflow_id",
    "batch",
    "idempotency_key"
  ],
  "$defs": {
    "WorkflowRunBatchCreate": {
      "additionalProperties": false,
      "description": "Start one run per object — the multi-select gallery / catalog backfill.",
      "properties": {
        "version_id": {
          "anyOf": [
            {
              "format": "uuid",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Version Id"
        },
        "object_type": {
          "maxLength": 100,
          "minLength": 1,
          "pattern": "^[a-z][a-z0-9_.-]*$",
          "title": "Object Type",
          "type": "string"
        },
        "object_ids": {
          "items": {
            "type": "string"
          },
          "maxItems": 50,
          "minItems": 1,
          "title": "Object Ids",
          "type": "array"
        },
        "payload": {
          "additionalProperties": true,
          "title": "Payload",
          "type": "object"
        },
        "slot_bindings": {
          "additionalProperties": true,
          "title": "Slot Bindings",
          "type": "object"
        }
      },
      "required": [
        "object_type",
        "object_ids"
      ],
      "title": "WorkflowRunBatchCreate",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "title": "StartWorkflowRunBatchInput"
}

list_production_workflow_runs

List run history, newest first, filterable by workflow and status.

Parameters4

workflow_id	any	optional	Filter to a specific workflow ID
status	any	optional	Filter to a workflow run status
page	integer	optional	Page number for workflow run results
items_per_page	integer	optional	Number of workflow runs per page

Raw schema

{
  "type": "object",
  "properties": {
    "workflow_id": {
      "anyOf": [
        {
          "format": "uuid",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter to a specific workflow ID",
      "title": "Workflow Id"
    },
    "status": {
      "anyOf": [
        {
          "$ref": "#/$defs/WorkflowRunStatus"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Filter to a workflow run status"
    },
    "page": {
      "default": 1,
      "description": "Page number for workflow run results",
      "minimum": 1,
      "title": "Page",
      "type": "integer"
    },
    "items_per_page": {
      "default": 50,
      "description": "Number of workflow runs per page",
      "maximum": 100,
      "minimum": 1,
      "title": "Items Per Page",
      "type": "integer"
    }
  },
  "$defs": {
    "WorkflowRunStatus": {
      "enum": [
        "rejected_insufficient_credits",
        "queued",
        "running",
        "succeeded",
        "succeeded_with_failures",
        "failed",
        "cancelled"
      ],
      "title": "WorkflowRunStatus",
      "type": "string"
    }
  },
  "additionalProperties": false,
  "title": "ListWorkflowRunsInput"
}

get_production_workflow_run

Read one run in full: stable accepted results, per-node status, media, errors, retries, and the credits it moved.

Parameters1

workflow_run_id

string

required

Workflow run ID

Raw schema

{
  "type": "object",
  "properties": {
    "workflow_run_id": {
      "description": "Workflow run ID",
      "format": "uuid",
      "title": "Workflow Run Id",
      "type": "string"
    }
  },
  "required": [
    "workflow_run_id"
  ],
  "additionalProperties": false,
  "title": "WorkflowRunIdentityInput"
}

get_production_workflow_control

Read the company kill switch — whether automation is stopped, and why.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false,
  "title": "_ToolInput"
}

update_production_workflow_control

Stop or resume ALL production automation for the company. Stopping requires a reason and is audited.

Parameters1

control

any

required

Company-wide workflow execution stop or resume setting and optional reason

Raw schema

{
  "type": "object",
  "properties": {
    "control": {
      "$ref": "#/$defs/WorkflowControlUpdate",
      "description": "Company-wide workflow execution stop or resume setting and optional reason"
    }
  },
  "required": [
    "control"
  ],
  "$defs": {
    "WorkflowControlUpdate": {
      "additionalProperties": false,
      "properties": {
        "stopped": {
          "title": "Stopped",
          "type": "boolean"
        },
        "reason": {
          "anyOf": [
            {
              "maxLength": 1000,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Reason"
        }
      },
      "required": [
        "stopped"
      ],
      "title": "WorkflowControlUpdate",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "title": "UpdateWorkflowControlInput"
}

Install

Tools (77)

search_uwear_librarylist_garmentsget_garmentupload_garment_from_chat_fileupload_garment_from_public_urllist_avatarsupload_avatar_from_chat_filegenerate_avatar

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://api.uwear.ai/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "uwear": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.uwear.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.