Uwear

Saves a new brief on the board, inand placeshows ofit itson currentthe oneboard: the looks to shoot, their direction and their shots. The previous brief is kept (one that ran stays in Brief History). Returns the saved brief, or the problems to fix.

 ⟨126 unchanged words⟩ "array"}},"type":"object"},"OutputInput":{"additionalProperties":false,"description":"This brief's output; a field left out is kept, null follows the board's default again.","properties":{"aspect_ratio":{"default":null,"description":"Photo aspect ratio, e.g. \"3:4\".","pattern":"^\\d{1,2}(\\.\\d{1,2})?:\\d{1,2}(\\.\\d{1,2})?$","type":"string"},"duration":{"default":null,"description":"Video length in seconds.","minimum":1,"type":"integer"},"generate_audio":{"default":null,"description":"Whether videos have sound.","type":"boolean"},"resolution":{"default":null,"description":"Photo resolution, e.g. \"2K\".","pattern":"^\\d{1,2}(\\.\\d)?K$","type":"string"},"upscale_factor":{"anyOf":[{"type":"integer"},{"type":"number"}],"default":null,"description":"Upscale factor, e.g. 2.","gt":0}},"type":"object"},"ProposedDirection":{"additionalProperties":false,"anyOf":[{ ⟨15 unchanged words⟩  a saved art direction, or both; never neither.neither\n(``NO_DIRECTION``), so every brief says what runs.","properties":{"art_direction_id":{"default": ⟨19 unchanged words⟩ "prompt":{"default":null,"description":"TheYour directionwords infor wordsthis shoot, in English.English, Optional1-3 sentences. Write one direction for every look from what the user wants (setting, light, mood, poses, purpose). Never name a garment, model, location or look: the same words run on every look. Not needed with an art_direction_id.","maxLength":2000,"type" ⟨14 unchanged words⟩  shots and their steps.","properties":{"aspect_ratio":{"default":null,"description":"Photo aspect ratio, e.g. \"3:4\".","pattern":"^\\d{1,2}(\\.\\d{1,2})?:\\d{1,2}(\\.\\d{1,2})?$","type":"string"},"image_model":{"default":null,"description":"A ⟨41 unchanged words⟩ "minLength":1,"type":"string"},"resolution":{"default":null,"description":"Photo resolution, e.g. \"2K\".","pattern":"^\\d{1,2}(\\.\\d)?K$","type":"string"},"shots":{"description":"One shot per view ⟨134 unchanged words⟩ clothing_detail_back, clothing_detail_side.","type":"string"},"factor":{"default":null,"description":"upscale only: the upscale factor, e.g. 2.","exclusiveMinimum":0,"type":"number"},"kind":{"description":"camera_edit: the same  ⟨37 unchanged words⟩ ,"remove_background"],"type":"string"},"length_seconds":{"default":null,"description":"video only: the video length in seconds.","minimum":1,"type":"integer"},"prompt":{"default":null,"description":"edit ⟨7 unchanged words⟩ ","maxLength":1000,"type":"string"},"sound":{"default":null,"description":"video only: whether the video has sound.","type":"boolean"}},"required":["kind"],"type":" ⟨21 unchanged words⟩ ":{"$ref":"#/$defs/ProposedDirection","description":"TheRequired: brief'swhat directionevery shot of every look follows, exactly what Generate runs: prompt, art_direction_id (a saved art direction), or both."},"image_model":{"default":null,"description":"The brief'sWrite imageone modeldirection (afor slugevery look from brief_inputs.ai_modelswhat the user wants (setting, light, mood, poses, purpose). NotNever withname recipe."a garment,"type" model, location or look:"string the same words run on every look."},"looks":{"description":"The looks ⟨18 unchanged words⟩ "minItems":1,"type":"array"},"output":{"$ref":"#/$defs/OutputInput","default":null,"description":"This brief's output settings; a field left out keeps the brief's."},"recipe":{"$ref":"#/$defs/RecipeSpec","default": ⟨25 unchanged words⟩ ":{"default":null,"description":"An Automationautomation forfrom theread_shoot_board's looksbrief_inputs.automations that every look runs through as is (aonly workflow_idwhen fromit brief_inputs.automationsmatches what the user asked for). Not with recipe. Omitted while the board pins one (brief_inputs.pinned_automation): every look runs it.","pattern":"^[0-9a-fA-F]{8}-[ ⟨25 unchanged words⟩ words; otherwise leave it out.","maxLength":80,"type":"string"},"video_model":{"default":null,"description":"The brief's video model (a slug from brief_inputs.ai_models). Not with recipe.","type":"string"}},"required":[ ⟨5 unchanged words⟩ 

SavesUse athis revisedwhen versionthe ofuser asks in chat to change the board's brief: brief_idits onlooks, Models, outfits, Locations, references, name, shots and steps, AI model or art direction. Send the boardcomplete replacement look list with the brief_id it replaces, keeping each unchanged look's key. Shots or steps: recipe with the complete new lookshot list (unchangedrecipe_look_keys looksfor keepsome theirlooks keyonly) andor recipe_workflow_id. AI model only: theimage_model fields/ thatvideo_model. change.Art Returnsdirection only: art_direction_id. Saves the revised brief, oron the board; nothing runs. If the result lists problems, tofix fix.them all and call again; on revision_conflict, meansread the board's briefboard changedand sincerevise youits readcurrent it.brief.

 ⟨126 unchanged words⟩ "array"}},"type":"object"},"OutputInput":{"additionalProperties":false,"description":"This brief's output; a field left out is kept, null follows the board's default again.","properties":{"aspect_ratio":{"default":null,"description":"Photo aspect ratio, e.g. \"3:4\".","pattern":"^\\d{1,2}(\\.\\d{1,2})?:\\d{1,2}(\\.\\d{1,2})?$","type":"string"},"duration":{"default":null,"description":"Video length in seconds.","minimum":1,"type":"integer"},"generate_audio":{"default":null,"description":"Whether videos have sound.","type":"boolean"},"resolution":{"default":null,"description":"Photo resolution, e.g. \"2K\".","pattern":"^\\d{1,2}(\\.\\d)?K$","type":"string"},"upscale_factor":{"anyOf":[{"type":"integer"},{"type":"number"}],"default":null,"description":"Upscale factor, e.g. 2.","gt":0}},"type":"object"},"ProposedDirection":{"additionalProperties":false,"anyOf":[{ ⟨15 unchanged words⟩  a saved art direction, or both; never neither.neither\n(``NO_DIRECTION``), so every brief says what runs.","properties":{"art_direction_id":{"default": ⟨19 unchanged words⟩ "prompt":{"default":null,"description":"TheYour directionwords infor wordsthis shoot, in English.English, Optional1-3 sentences. Write one direction for every look from what the user wants (setting, light, mood, poses, purpose). Never name a garment, model, location or look: the same words run on every look. Not needed 

 ⟨10 unchanged words⟩ its current one: the looks to shoot, thetheir direction every shot follows and the Automation every look runs through. Nothing runs or istheir charged.shots. Returns the brief with its creditsaved quotebrief, or the problems to fix.

 ⟨19 unchanged words⟩  key) and only the fields that change. Nothing runs or is charged. Returns the revised brief with its credit quote, or the problems to fix. revision_conflict means  ⟨8 unchanged words⟩ 

{"additionalProperties":false,"description":"Input schema for listing generation results." ⟨338 unchanged words⟩ 

{"additionalProperties":false,"description":"Input schema for checking generation status." ⟨53 unchanged words⟩ 

 ⟨15 unchanged words⟩  look's run of brief_id with its status, error, credits and, results (generation_result_id, kind, url) by step.step and the error of every step that failed (failures lists them all). Read it again until done is true; while ⟨17 unchanged words⟩ 

 ⟨171 unchanged words⟩ the board's default (the user's\npreferences) again. Every step it is for (a Shoot, a Video, an Upscale) runs and is priced on it.","properties" ⟨34 unchanged words⟩ 2})?$","type":"string"},"duration":{"default":null,"description":"Video steps only: the clip's length in seconds, one of the video model's durations (a longer one costs more).","minimum":1,"type":"integer"},"generate_audio":{"default":null,"description":"Video steps only: true for a clip with sound (only a video model that supports audio), false for a silent one.","type":"boolean"},"op":{"const":"brief.output","type": ⟨28 unchanged words⟩ ,2}(\\.\\d)?K$","type":"string"},"upscale_factor":{"anyOf":[{"type":"integer"},{"type":"number"}],"default":null,"description":"Upscale steps only: e.g. 2, 4: one of the upscale model's upscale_factors.","gt":0}},"required":["op"],"type" ⟨518 unchanged words⟩ 

Use this when the user describes a shoot. Saves a brief, the looks to shoot and the automation they run through, and linksnew itbrief toon the board, in place of theits current one. Nothing runs or is chargedone: show the user the looks and the credit quote; confirm_brief runs it when they ask.to Readshoot, the boarddirection firstevery withshot read_shoot_boardfollows and follow brief_inputs.guide. If the result lists problems, fix them all andAutomation callevery again.look "Runruns thethrough. same"Nothing forruns otheror clothing:is passcharged. from_brief_idReturns (the brief thatwith ran)its andcredit quote, or the newproblems looksto only.fix.

 ⟨149 unchanged words⟩ "aspect_ratio":{"default":null,"description":"e.g.Photo \"3:4\",aspect \"1:1\"ratio, e.g. \"93:16\4\": one of the shoot image model's aspect_ratios..","pattern":"^\\d{1,2}(\\.\\d{ ⟨8 unchanged words⟩ 2})?$","type":"string"},"resolutionduration":{"default":null,"description":"e.g.Video \length in seconds."1K\,"minimum":1, \"2K\type":"integer"}

 ⟨58 unchanged words⟩ , 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 chargedis again.free. QA is built for scale — validating large ⟨42 unchanged words⟩ 

 ⟨12 unchanged words⟩ {"description":"Generation result IDs to QA. Queued or requeued QA costs 1 credit peris result.free.","items":{"type":"integer"}, ⟨33 unchanged words⟩ 

 ⟨95 unchanged words⟩  has a brief, apply it with update_brief art_direction_id.direction.art_direction_id. If the result lists problems, fix them all and call again.

Use this when the user asks in chatSaves toa changerevised theversion board'sof brief: its looks, Models, outfits, Locations, references, name, shots and steps, AI model or art direction. Send the complete replacement look list with the brief_id it replaces, keeping each unchanged look's key. Shotson orthe stepsboard: recipe with the complete new shotlook list (recipe_look_keysunchanged forlooks somekeep lookstheir onlykey) or recipe_workflow_id.and AIonly modelthe only:fields image_modelthat /change. video_model.Nothing Artruns directionor only:is art_direction_id.charged. SavesReturns the revised brief on the board; nothing runswith (confirm_briefits runscredit it).quote, Ifor the result lists problems, fix them all and call again;to onfix. revision_conflict, readmeans the boardboard's andbrief revisechanged itssince currentyou brief.read it.

 ⟨149 unchanged words⟩ "aspect_ratio":{"default":null,"description":"e.g.Photo \"3:4\",aspect \"1:1\"ratio, e.g. \"93:16\4\": one of the shoot image model's aspect_ratios..","pattern":"^\\d{1,2}(\\.\\d{ ⟨8 unchanged words⟩ 2})?$","type":"string"},"resolutionduration":{"default":null,"description":"e.g.Video \length in seconds."1K\,"minimum":1, \"2K\type":"integer"}

GenerateSpends acredits: Shootcall Boardit only when the user agreed in chat to run the brief: publishesat its automationcredit drafts,quote. thenTheir startsmessage oneasking workflowto generate or run perit look,("run chargedthe persame run.for Spendsthese") creditsis that agreement: callstate itthe onlyquote afterin the usersame hasreply, seenthen thecall. brief'sOtherwise looksgive the quote and creditwait quotefor (get_brief)their andyes; agreeda inrequest chat.to Passchange the board'sbrief brief_revisionis (read_shoot_board)not one. Pass brief.revision and brief.quote.total_credits of your last propose_brief, update_brief or get_brief result as expected_brief_revision and expected_total_credits, and idempotency_key brief-{brief_id}-r{revision} (a freshretry idempotency_key;with the same idempotency_keykey never publishes, runs or charges twice.twice). FollowOn quote_changed, tell the runsuser the new quote and wait for their yes. Then follow it with mcp_brief_runs.

 ⟨52 unchanged words⟩ :{"description":"Retry key for one Generate tap: the same key never runs or charges twice.","maxLength": ⟨12 unchanged words⟩ 

ReadUse onethis ofwhen theyou account'sneed a Shoot Board briefsbrief by brief_id: its looks, automations, credit quote (quote.total_credits), status and status.revision. ChangesShows it on the board; spends nothing.

Get GenerationShow 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.Use Theythis areto displayshow previews,results notin originalschat: 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=[...],from execute_immediately=truemcp_brief_runs) when the user asked tofor runone nowresult, update_briefgeneration_id for a complete commandjob's replacementresults, or confirm_brief(execute=true) for a visible brief. Pass generation_result_id to fetch onequery, resultfilters orand generation_iddates to list a job's results. Defaults tofind compactpast resultones. metadata.Returns Setimage include_snapshot=truepreviews to recover fullshow settings,as resourcethey snapshotsare and(never priorMarkdown-embed prompts.result UseURLs); start_date/end_dateurl foris requeststhe likeoriginal. 'lastChanges week'.nothing.

 ⟨4 unchanged words⟩ openWorldHint":false,"readOnlyHint":true,"title":"Get GenerationShow Results"}

Get Generation Status

Check generation job status. Completed results may include labeled native ImageContent previews; use them directly and never Markdown-embedUse resultthis URLs.to Theycheck areone displaygeneration previews,job notby originalsgeneration_id: url/download_url are originals, preview_url is the fallback link, and poster_url/thumbnail_url is a video poster. Returns compactits status, parent/child generation IDs, camera, avatar_id, model_id, model_slug,credits use_caseand, net credits_charged,when credits_refunded,it estimated_processing_secondsfailed, and status_guidance. Failed jobs also return a safe error_message and error_type (user, transient, or provider). Set include_snapshot=true to recover full settings, resource snapshots and prior prompts. Status can remain Created while queued/preparing; avoid tight polling loops.error_message. UIA 'Geminibrief's Pro'runs mapsare toread model_slugwith nano-banana-promcp_brief_runs. orChanges nano_banana_pro_clothing.nothing.

 ⟨4 unchanged words⟩ openWorldHint":false,"readOnlyHint":true,"title":"Get Generation Status"}

Follow Brief Runs

EveryUse this after confirm_brief or when the user asks how a shoot is going: each look's run of abrief_id generatingwith briefits status, error, credits and results (brief_id)generation_result_id, orkind, runsurl) by idstep. (workflow_run_idsRead it again until done is true; while it runs, eachsay withso (the look itsboard cardsshows heldprogress):. status,Then show the results bywith step,get_generation_results. credits.Changes nothing.

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Follow Brief Runs"}

 ⟨116 unchanged words⟩ 0-9a-fA-F]{64}$","type":"string"},"side":{"description":"A new garment only: the side its photo shows (default front; back: it is also its back photo)","enum":["front","back"],"type":"string"}},"required":["image_url","kind"," ⟨15 unchanged words⟩ 

 ⟨152 unchanged words⟩ ["op"],"type":"object"},"BriefOutputSet":{"additionalProperties":false,"description":"Set this brief's output: a field left out is kept, null follows the board's default (the user's\npreferences) again. Every Shoot runs and is priced on it.","properties":{"aspect_ratio":{"default":null,"description":"e.g. \"3:4\", \"1:1\", \"9:16\": one of the shoot image model's aspect_ratios.","pattern":"^\\d{1,2}(\\.\\d{1,2})?:\\d{1,2}(\\.\\d{1,2})?$","type":"string"},"op":{"const":"brief.output","type":"string"},"resolution":{"default":null,"description":"e.g. \"1K\", \"2K\", \"4K\": one of the shoot image model's resolutions (a higher one costs more).","pattern":"^\\d{1,2}(\\.\\d)?K$","type":"string"}},"required":["op"],"type":"object"},"BriefRefresh":{"additionalProperties":false,"description":"Re-pin ⟨458 unchanged words⟩ brief.discard":"#/$defs/BriefDiscard","brief.models":"#/$defs/BriefModelsSet","brief.output":"#/$defs/BriefOutputSet","brief.refresh":"#/$defs/BriefRefresh","brief.restore":"#/$defs/BriefRestore"," ⟨19 unchanged words⟩ "$ref":"#/$defs/BriefDirectionSet"},{"$ref":"#/$defs/BriefModelsSet"},{"$ref":"#/$defs/BriefOutputSet"},{"$ref":"#/$defs/BriefRefresh"},{"$ref ⟨16 unchanged words⟩ 

 ⟨38 unchanged words⟩ show the user the looks and the credit quote (get_brief), and generate withquote; confirm_brief onlyruns afterit when they agree.ask. Read the board first with read_shoot_board and follow ⟨4 unchanged words⟩ lists problems, fix them all and call again. "Run the same" for other clothing: pass from_brief_id (the brief that ran) and the new looks only.

 ⟨126 unchanged words⟩ "array"}},"type":"object"},"OutputInput":{"additionalProperties":false,"description":"This brief's output; a field left out is kept, null follows the board's default again.","properties":{"aspect_ratio":{"default":null,"description":"e.g. \"3:4\", \"1:1\", \"9:16\": one of the shoot image model's aspect_ratios.","pattern":"^\\d{1,2}(\\.\\d{1,2})?:\\d{1,2}(\\.\\d{1,2})?$","type":"string"},"resolution":{"default":null,"description":"e.g. \"1K\", \"2K\", \"4K\": one of the shoot image model's resolutions (a higher one costs more).","pattern":"^\\d{1,2}(\\.\\d)?K$","type":"string"}},"type":"object"},"ProposedDirection":{"additionalProperties":false,"anyOf":[{ ⟨402 unchanged words⟩ },"direction":{"$ref":"#/$defs/ProposedDirection","default":null,"description":"Required unless from_brief_id: what every shot of every look follows, ⟨38 unchanged words⟩  same words run on every look."},"from_brief_id":{"default":null,"description":"\"The same\" on other clothing: a brief_id that ran. The new brief keeps its automations as they are now, its direction, AI model and output (leave out direction, recipe and recipe_workflow_id); a model_id, location_id or reference_ids left out or empty is that brief's looks' in turn. If the user asked to run it, call confirm_brief in the same turn; otherwise do not.","minimum":1,"type":"integer"},"looks":{"description":"The looks to shoot ⟨16 unchanged words⟩ "minItems":1,"type":"array"},"output":{"$ref":"#/$defs/OutputInput","default":null,"description":"The shoot's aspect ratio and resolution, only when the user asked for them; omit to keep the brief's (the user's preferences by default). The brief's output is what runs and is priced; a value the image model does not offer runs at the nearest one it does."},"recipe":{"$ref":"#/$defs/RecipeSpec","default": ⟨101 unchanged words⟩ type":"string"}},"required":["looks","direction","board_id"],"type":"object"}

 ⟨71 unchanged words⟩ Saves the revised brief on the board; nothing runs.runs (confirm_brief runs it). If the result lists problems, fix them  ⟨14 unchanged words⟩ 

 ⟨126 unchanged words⟩ "array"}},"type":"object"},"OutputInput":{"additionalProperties":false,"description":"This brief's output; a field left out is kept, null follows the board's default again.","properties":{"aspect_ratio":{"default":null,"description":"e.g. \"3:4\", \"1:1\", \"9:16\": one of the shoot image model's aspect_ratios.","pattern":"^\\d{1,2}(\\.\\d{1,2})?:\\d{1,2}(\\.\\d{1,2})?$","type":"string"},"resolution":{"default":null,"description":"e.g. \"1K\", \"2K\", \"4K\": one of the shoot image model's resolutions (a higher one costs more).","pattern":"^\\d{1,2}(\\.\\d)?K$","type":"string"}},"type":"object"},"ProposedDirection":{"additionalProperties":false,"anyOf":[{ ⟨541 unchanged words⟩ ":50,"minItems":1,"type":"array"},"output":{"$ref":"#/$defs/OutputInput","default":null,"description":"The shoot's aspect ratio and resolution, only when the user asked for them; omit to keep the brief's (the user's preferences by default). The brief's output is what runs and is priced; a value the image model does not offer runs at the nearest one it does."},"recipe":{"$ref":"#/$defs/RecipeSpec", ⟨153 unchanged words⟩ 

 ⟨126 unchanged words⟩ "array"}},"type":"object"},"ProposedDirection":{"additionalProperties":false,"anyOf":[{"required":["prompt"]},{"required":["art_direction_id"]}],"description":"The shoot's Direction as the host writes it: its words, a saved art direction, or both; never neither\n(``NO_DIRECTION``), so every brief says what runs.","properties":{"art_direction_id":{"default":null,"description":"A saved art direction (a library id, or the id save_art_direction returns).","minimum":1,"type":"integer"},"prompt":{"default":null,"description":"Your words for this shoot, in English, 1-3 sentences. Write one direction for every look from what the user wants (setting, light, mood, poses, purpose). Never name a garment, model, location or look: the same words run on every look. Not needed with an art_direction_id.","maxLength":2000,"type":"string"}},"type":"object"},"RecipeSpec":{"additionalProperties":false,"description":"The ⟨270 unchanged words⟩ "}},"additionalProperties":false,"properties":{"art_direction_id":{"default":null,"description":"A new art direction for the whole shoot (omit: kept). Changing it never changes the automation. For a new look and feel, call save_art_direction first and pass its id.","minimum":1,"type":"integer"},"board_id":{"description":"The open Shoot Board's ⟨20 unchanged words⟩  read_shoot_board.","minimum":1,"type":"integer"},"direction":{"$ref":"#/$defs/ProposedDirection","default":null,"description":"A new Direction for the whole shoot, replacing the brief's (omit: kept): prompt, art_direction_id (a saved art direction), or both. Write one direction for every look from what the user wants (setting, light, mood, poses, purpose). Never name a garment, model, location or look: the same words run on every look."},"image_model":{"default":null,"description ⟨223 unchanged words⟩ 

Reopen SavedRead 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 newRead photoshoot.one Whenof the useraccount's asksShoot toBoard modify,briefs rewrite,by addbrief_id: stepsits tolooks, or show an adjusted briefautomations, call update_brief with the complete updated briefcredit insteadquote ofand loopingstatus. onChanges get_brief.nothing.

{"descriptionadditionalProperties":"Input schema for loading a persisted brief for UI rehydration."false,"properties":{"brief_idboard_id":{"description":"Real persisted brief ID to load unchanged. Do notThe useopen 0,Shoot guessedBoard's IDsboard_id, or thisfrom toolOpen forShoot editingBoard aor visibleyour brief.

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":truefalse,"title":"Reopen SavedRead Brief"}

 ⟨105 unchanged words⟩ result or generation_id to list a job's results. ReturnsDefaults rawto payloadcompact whenresult availablemetadata. soSet priorinclude_snapshot=true promptsto canrecover befull recovered.settings, resource snapshots and prior prompts. Use start_date/end_date for requests like 'last week'.

 ⟨152 unchanged words⟩  result directly.","type":"integer"},"include_snapshot":{"default":false,"description":"Include full generation settings, resource snapshots and raw prompt payloads. Large; use only for prompt recovery.","type":"boolean"},"kind":{"default":null,"description":"Filter ⟨162 unchanged words⟩ 

 ⟨34 unchanged words⟩ , and poster_url/thumbnail_url is a video poster. Returns compact status, rawparent/child payloadgeneration IDs, settingscamera, avatar_id, model_id, model_slug, use_case, net  ⟨12 unchanged words⟩ and error_type (user, transient, or provider). Set include_snapshot=true to recover full settings, resource snapshots and prior prompts. Status can remain Created while queued/preparing; avoid tight ⟨11 unchanged words⟩ 

 ⟨9 unchanged words⟩ description":"The generation ID to check. Returns raw payload,compact generation_settingstatus, 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"},"include_snapshot":{"default":false,"description":"Include full generation settings, resource snapshots and raw prompt payloads. Large; use only for prompt recovery.","type":"boolean"}},"required":["generation_id"],"type":"object"}

List AvatarsModels

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

 ⟨5 unchanged words⟩ :false,"readOnlyHint":true,"title":"List AvatarsModels"}

 ⟨17 unchanged words⟩ is ORed with category when both are given. GarmentsWith maya havecategory noor category.body_zone Afilter categoryand orinclude_uncategorized=false, body_zoneuncategorized_count reports garments hidden by the category filter excludeswithin themthe unlesssame include_uncategorizedscope. isIf true.matches are short and uncategorized_count > 0, call again with include_uncategorized=true and inspect those garments.

 ⟨186 unchanged words⟩  category when category and/or body_zone filters are used. If the first result has uncategorized_count > 0 and too few matches, call again with true and inspect those garments.","type":"boolean"},"limit":{ ⟨98 unchanged words⟩ 

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

{"properties":{"board_id":{"description":"The open Shoot Board's board_id, from Open Shoot Board or your context.","type":"string"},"board_version":{"description":"Pass 2 to receive board v2 state, including the board's output settings","enum":[2],"type":"integer"},"context_items":{"description":"Shoot Board items to append to the current list","items":{"properties":{"description":{"maxLength":500,"type":"string"},"gender":{"maxLength":40,"type":"string"},"id":{"oneOf":[{"type":"integer"},{"type":"string"}]},"intake":{"description":"Board v2: intake state of an item still being sorted; absent means ready","properties":{"candidates":{"items":{"enum":["clothing","models","outfits","generations","files","locations","art_directions","automations"],"type":"string"},"type":"array"},"source_hash":{"description":"sha256 hex of the source file","type":["string","null"]},"status":{"enum":["sorting","needs_answer","ready"],"type":"string"}},"required":["status"],"type":["object","null"]},"isVideo":{"type":"boolean"},"key" ⟨3 unchanged words⟩ "type":["string","null"]},"meta":{"description":"Short display facts, e.g. ['female', 'ID 7']","items":{"type":["string","number","boolean"]},"maxItems":8,"type":"array"},"name":{"type":"string"},"posterUrl" ⟨17 unchanged words⟩ ,"outfits","generations","files","locations","art_directions","automations"],"type":"string"}},"required": ⟨2 unchanged words⟩ type":"object"},"type":"array"},"expected_revision":{"description":"Board revision this write is based on; a stale revision returns a revision_conflict error with the current board instead of overwriting it","minimum":0,"type":"integer"}},"required":["context_items","board_id","expected_revision"],"type":"object"}

App-only: clearClear all sessionShoot contextBoard items, or only one context type.

{"properties":{"board_id":{"description":"The open Shoot Board's board_id, from Open Shoot Board or your context.","type":"string"},"board_version":{"description":"Pass 2 to receive board v2 state, including the board's output settings","enum":[2],"type":"integer"},"expected_revision":{"description":"Board revision this write is based on; a stale revision returns a revision_conflict error with the current board instead of overwriting it","minimum":0,"type":"integer"},"type":{"description":"Context type to remove; omit to clear the  ⟨8 unchanged words⟩ ,"file","files","location","locations","art_direction","art_directions","automation","automations"],"type":"string"}},"required":["board_id","expected_revision"],"type":"object"}

App-only: export the user-confirmedExport montage clips as aone stitched video. Spends credits,: socall it is hidden from hostonly LLMs;after the MCP iframe calls thisuser afterconfirmed the user pressesclips Exportand ontheir theorder MontageProposalin card.chat. Returns the generation_id to poll viawith get_generation_status.

{"destructiveHint":true,"idempotentHint":false,"openWorldHint":false,"readOnlyHint":false,"title":"Export Montage Video"}

App-only: queueQueue an image-to-video generation for aone montage clip. Spends credits,: socall it is hidden from host LLMs; the montage editor calls thisonly whenafter the user presses Generate on aagreed draftin clip.chat. Returns the generation_id to poll viawith get_generation_status.

{"destructiveHint":true,"idempotentHint":false,"openWorldHint":true,"readOnlyHint":false,"title":"Generate Montage Clip"}

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

{"properties":{"board_id":{"description":"The open Shoot Board's board_id, from Open Shoot Board or your context.","type":"string"},"board_version":{"description":"Pass 2 to receive board v2 state, including the board's output settings","enum":[2],"type":"integer"}},"required":["board_id"],"type":"object"}

App-only: listList uploaded (reference) files for the Uwear MCP workspace files tab and the Shoot Board's References tab.

 ⟨24 unchanged words⟩ ","minimum":1,"type":"integer"},"query":{"description":"Optional search over file names and tags (the Shoot Board's References tab)","type":"string"},"tag_ids":{"description":"Optional: only files with any of these tags","items":{"type":"integer"},"type":"array"}},"required":[],"type":"object"}

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

{"properties":{"board_id":{"description":"The open Shoot Board's board_id, from Open Shoot Board or your context.","type":"string"},"board_version":{"description":"Pass 2 to receive board v2 state, including the board's output settings","enum":[2],"type":"integer"},"context_items":{"description":"Shoot Board items that ⟨6 unchanged words⟩ is omitted","items":{"properties":{"description":{"maxLength":500,"type":"string"},"gender":{"maxLength":40,"type":"string"},"id":{"oneOf":[{"type":"integer"},{"type":"string"}]},"intake":{"description":"Board v2: intake state of an item still being sorted; absent means ready","properties":{"candidates":{"items":{"enum":["clothing","models","outfits","generations","files","locations","art_directions","automations"],"type":"string"},"type":"array"},"source_hash":{"description":"sha256 hex of the source file","type":["string","null"]},"status":{"enum":["sorting","needs_answer","ready"],"type":"string"}},"required":["status"],"type":["object","null"]},"isVideo":{"type":"boolean"},"key" ⟨3 unchanged words⟩ "type":["string","null"]},"meta":{"description":"Short display facts, e.g. ['female', 'ID 7']","items":{"type":["string","number","boolean"]},"maxItems":8,"type":"array"},"name":{"type":"string"},"posterUrl" ⟨17 unchanged words⟩ ,"outfits","generations","files","locations","art_directions","automations"],"type":"string"}},"required": ⟨27 unchanged words⟩ "items":{"items":{"properties":{"description":{"maxLength":500,"type":"string"},"gender":{"maxLength":40,"type":"string"},"id":{"oneOf":[{"type":"integer"},{"type":"string"}]},"intake":{"description":"Board v2: intake state of an item still being sorted; absent means ready","properties":{"candidates":{"items":{"enum":["clothing","models","outfits","generations","files","locations","art_directions","automations"],"type":"string"},"type":"array"},"source_hash":{"description":"sha256 hex of the source file","type":["string","null"]},"status":{"enum":["sorting","needs_answer","ready"],"type":"string"}},"required":["status"],"type":["object","null"]},"isVideo":{"type":"boolean"},"key" ⟨3 unchanged words⟩ "type":["string","null"]},"meta":{"description":"Short display facts, e.g. ['female', 'ID 7']","items":{"type":["string","number","boolean"]},"maxItems":8,"type":"array"},"name":{"type":"string"},"posterUrl" ⟨17 unchanged words⟩ ,"outfits","generations","files","locations","art_directions","automations"],"type":"string"}},"required": ⟨3 unchanged words⟩ :"object"},"type":"array"},"output":{"description":"Board v2: the shoot's output settings; omitted keys keep their current value","properties":{"aspect_ratio":{"description":"e.g. \"3:4\"","type":["string","null"]},"model_slug":{"type":["string","null"]},"num_images":{"minimum":1,"type":["integer","null"]},"resolution":{"description":"e.g. \"2K\"","type":["string","null"]}},"type":["object","null"]},"pendingRequest":{"type":["object","null" ⟨8 unchanged words⟩ ":"string"}},"type":"object"},"expected_revision":{"description":"Board revision this write is based on; a stale revision returns a revision_conflict error with the current board instead of overwriting it","minimum":0,"type":"integer"}},"required":["board_id","expected_revision"],"type":"object"}

App-only: saveSave aan user-editededited image from the shared ImageDetail retouch editor(image_base64) as a child generation result. Hidden from host LLMs; the MCPnew iframechild callsresult thisof afterparent_generation_result_id. theChanges userno pressesexisting Save.result.

{"destructiveHint":false,"idempotentHint":false,"openWorldHint":false,"readOnlyHint":false,"title":"Save Retouched Image"}

CreatePropose Brief for Approval

Create a Uwear BriefProposal from canonical generation commands. EveryUse commands[].inputthis iswhen the MCP-safe GenerationIntent fields; commands and immutable plans are persisted without translation.user Supplydescribes a concrete model_slug forshoot. generate,Saves edit,a upscalebrief, and video. Use durable command.source IDs for uploaded filesthe orlooks generationto results,shoot and reference_attachments forthe additionalautomation references.they Forrun videothrough, attach available full back or sideand garmentlinks assetsit thatto the cameraboard mayin revealplace whenof capacitythe permits;current havingone. theNothing assetruns uploadedor is not enough.charged: Ifshow the responseuser containsthe video_garment_view_not_attached,looks explainand itsthe exactcredit assets,quote node(get_brief), and capacity, then follow its remediation. Never mix reference_attachmentsgenerate with img_ref_urls or append recommendations beyond remaining capacity. Set execute_immediately=trueconfirm_brief only when the user explicitly asks to run now. Include creative_context forafter photoshootsthey andagree. explainRead the art direction after proposing. For changesboard tofirst awith visibleread_shoot_board brief,and callfollow update_briefbrief_inputs.guide. withIf the completeresult replacementlists commandproblems, list.fix Webhookthem callbackall configurationand iscall API-only.again.

{"destructiveHint":truefalse,"idempotentHint":false,"openWorldHint":truefalse,"readOnlyHint":false,"title":"CreatePropose Brief for Approval"}

 ⟨325 unchanged words⟩ "minimum":360,"type":"integer"},"board_id":{"description":"The open Shoot Board's board_id, from Open Shoot Board or your context.","type":"string"},"items":{"description":"Ordered list of montage ⟨30 unchanged words⟩ 

{"destructiveHint":false,"idempotentHint":truefalse,"openWorldHint":false,"readOnlyHint":truefalse,"title":"Create Video Montage"}

Ask User toNew PickShoot AssetsBoard

FIRST tool to call for a new photoshootUse onlythis when the user has not supplied garment/outfit IDs or textual selectors such as tag names, saved ArtDirection names, location names, or outfitwants names.a Opensphotoshoot theand MCPyou app/galleryhave sono theboard_id useryet. canCreates choosea assetsnew, add them toempty theUwear Shoot Board, and press Confirm context. BLOCKS untilreturns theits userboard_id, confirmswhich theirevery selection.other DoShoot notBoard usetool thistakes. whenThis aclient no-UIshows pathno canwidget: resolvebuild the requestshoot with list_tags/get_items_by_tag/list_garments or the ArtDirectiontools lookup(search_uwear_library, tools.modify_shoot_board, Dopropose_brief) notand 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/modelwhat is optional; only ask for one whenon 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 useboard. generate_avatarprompt: ifone theyline wantdescribing Uwearthe toshoot; createexpected_types: awhat reusableit model.needs.

 ⟨9 unchanged words⟩  from the MCP app/gallery.","properties":{"board_id":{"description":"The open Shoot Board's board_id, from Open Shoot Board or your context.","type":"string"},"expected_types":{"description":"Accepted item types ( ⟨66 unchanged words⟩ 

{"destructiveHint":false,"idempotentHint":truefalse,"openWorldHint":false,"readOnlyHint":truefalse,"title":"Ask User toNew PickShoot AssetsBoard"}

 ⟨36 unchanged words⟩ , and other reference images that are not garmentsClothing or avatars.Models.

{"$defs":{"OpenAIFile":{"additionalProperties":false,"properties":{"download_url":{"type":"string"},"file_id":{"type":"string"},"file_name":{"type":"string"},"mime_type":{"type":"string"}},"required":["download_url","file_id"],"type":"object"},"ReferenceChatFileUploadItem":{"description":"One reference file upload ⟨72 unchanged words⟩  from chat file references.","properties":{"board_id":{"description":"The open Shoot Board's board_id, from Open Shoot Board or your context.","type":"string"},"file_name":{"default":null,"description":"Single ⟨27 unchanged words⟩ ,"type":"array"},"image_file_1":{"$refadditionalProperties":"#/$defs/OpenAIFile"false,"description":"Host-provided uploaded file reference for  ⟨15 unchanged words⟩  the host, not a bare file_... ID.","properties":{"download_url":{"type":"string"},"image_file_10file_id":{"$reftype":"#/$defs/OpenAIFilestring"},"file_name":{"type":"string"},"mime_type":{"type":"string"}},"required":["download_url","file_id"],"type":"object"},"image_file_10":{"additionalProperties":false,"description":"Host-provided uploaded file reference for the  ⟨14 unchanged words⟩  the host, not a bare file_... ID.","properties":{"download_url":{"type":"string"},"image_file_2file_id":{"$reftype":"#/$defs/OpenAIFilestring"},"file_name":{"type":"string"},"mime_type":{"type":"string"}},"required":["download_url","file_id"],"type":"object"},"image_file_2":{"additionalProperties":false,"description":"Host-provided uploaded file reference for the  ⟨14 unchanged words⟩  the host, not a bare file_... ID.","properties":{"download_url":{"type":"string"},"image_file_3file_id":{"$reftype":"#/$defs/OpenAIFilestring"},"file_name":{"type":"string"},"mime_type":{"type":"string"}},"required":["download_url","file_id"],"type":"object"},"image_file_3":{"additionalProperties":false,"description":"Host-provided uploaded file reference for the  ⟨14 unchanged words⟩  the host, not a bare file_... ID.","properties":{"download_url":{"type":"string"},"image_file_4file_id":{"$reftype":"#/$defs/OpenAIFilestring"},"file_name":{"type":"string"},"mime_type":{"type":"string"}},"required":["download_url","file_id"],"type":"object"},"image_file_4":{"additionalProperties":false,"description":"Host-provided uploaded file reference for the  ⟨14 unchanged words⟩  the host, not a bare file_... ID.","properties":{"download_url":{"type":"string"},"image_file_5file_id":{"$reftype":"#/$defs/OpenAIFilestring"},"file_name":{"type":"string"},"mime_type":{"type":"string"}},"required":["download_url","file_id"],"type":"object"},"image_file_5":{"additionalProperties":false,"description":"Host-provided uploaded file reference for the  ⟨14 unchanged words⟩  the host, not a bare file_... ID.","properties":{"download_url":{"type":"string"},"image_file_6file_id":{"$reftype":"#/$defs/OpenAIFilestring"},"file_name":{"type":"string"},"mime_type":{"type":"string"}},"required":["download_url","file_id"],"type":"object"},"image_file_6":{"additionalProperties":false,"description":"Host-provided uploaded file reference for the  ⟨14 unchanged words⟩  the host, not a bare file_... ID.","properties":{"download_url":{"type":"string"},"image_file_7file_id":{"$reftype":"#/$defs/OpenAIFilestring"},"file_name":{"type":"string"},"mime_type":{"type":"string"}},"required":["download_url","file_id"],"type":"object"},"image_file_7":{"additionalProperties":false,"description":"Host-provided uploaded file reference for the  ⟨14 unchanged words⟩  the host, not a bare file_... ID.","properties":{"download_url":{"type":"string"},"image_file_8file_id":{"$reftype":"#/$defs/OpenAIFilestring"},"file_name":{"type":"string"},"mime_type":{"type":"string"}},"required":["download_url","file_id"],"type":"object"},"image_file_8":{"additionalProperties":false,"description":"Host-provided uploaded file reference for the  ⟨14 unchanged words⟩  the host, not a bare file_... ID.","properties":{"download_url":{"type":"string"},"image_file_9file_id":{"$reftype":"#/$defs/OpenAIFilestring"},"file_name":{"type":"string"},"mime_type":{"type":"string"}},"required":["download_url","file_id"],"type":"object"},"image_file_9":{"additionalProperties":false,"description":"Host-provided uploaded file reference for the  ⟨14 unchanged words⟩  the host, not a bare file_... ID.","properties":{"download_url":{"type":"string"},"file_id":{"type":"string"},"file_name":{"type":"string"},"mime_type":{"type":"string"}},"required":["download_url","file_id"],"type":"object"},"image_url":{"default":null,"description":"Single ⟨18 unchanged words⟩ , e.g. image/png","type":"string"}},"required":[],"type":"object"}

Universal hybridUse retrievalthis acrosswhen the user's visible Uwearuser library:names garmentsClothing, avatars/modelsModels, locationsLocations, ArtDirections,art uploadeddirections, files, andor generationpast results.results Thisin ischat aand finder,you notneed atheir recommender.ids. UseTakes a short keyword queriesquery (2 to 52-5 words), one concept per call, or an exact name/SKU/ID. Every word must match for lexical results; long sentences can return no lexical matches. A query describing one garment finds that garment, not complementary garments. Vector results stay close to the best match. Use this before opening the picker, e.g. 'SKU 42', 'urban art direction', 'summer denim', or 'studio model'. For saved outfits, retrieve matching garments firstname, then call list_outfits with clothing_item_idsSKU or propose_outfits from the garment IDs.id) Returnsand stablereturns typed IDs, ids_by_typeids, detail_tool/detail_arguments,names and selection hints; for saved ArtDirections, use the returned art_direction_id in briefs. This combines current lexical metadata with maintainedthumbnails. vectorIt retrieval.finds Interactiveitems; searchesit dodoes not refresh the index. indexed_count is always 0 here; it isrecommend notthem. indexChanges coverage.nothing.

ReplaceUse this when the visibleuser Uwearasks BriefProposalin withchat ato completechange canonicalthe commandboard's list.brief: Editits commands[].inputlooks, directlyModels, usingoutfits, theLocations, MCP-safereferences, GenerationIntentname, fieldsshots and preservesteps, everyAI unchangedmodel fieldor andart durabledirection. source.Send Thisthe iscomplete replacement statelook list with the brief_id it replaces, notkeeping aeach partialunchanged diff.look's Forkey. video_garment_view_not_attachedShots warnings,or followsteps: recipe with the capacity-awarecomplete remediation:new nevershot mixlist reference_attachments(recipe_look_keys withfor img_ref_urlssome looks only) or appendrecipe_workflow_id. recommendationsAI beyondmodel remainingonly: capacity.image_model Include/ updatedvideo_model. creative_contextArt fordirection photoshootonly: rewritesart_direction_id. andSaves explainthe revised brief on the changedboard; artnothing direction.runs. WebhookIf callbackthe configurationresult islists API-only.problems, fix them all and call again; on revision_conflict, read the board and revise its current brief.

 ⟨275 unchanged words⟩ "minimum":360,"type":"integer"},"board_id":{"description":"The open Shoot Board's board_id, from Open Shoot Board or your context.","type":"string"},"clear_trim":{"default":false,"description":"For ⟨210 unchanged words⟩ image-to-video montage items.","type":"string"}},"required":[],"type":"object"}

{"destructiveHint":false,"idempotentHint":truefalse,"openWorldHint":false,"readOnlyHint":truefalse,"title":"Update Video Montage"}

Upload AvatarsModels from Chat

Batch upload reusable avatars/modelsModels from person photos the user attached in chat. ⟨38 unchanged words⟩ not use ordinary text-to-image results as an upload fallback; use generate_avatar followed by save_generated_avatar for Uwear-created avatars.fallback. Use only when the user explicitly wants a specific or consistent person.

 ⟨124 unchanged words⟩ ":["name"],"type":"object"},"OpenAIFile":{"additionalProperties":false,"properties":{"download_url":{"type":"string"},"file_id":{"type":"string"},"file_name":{"type":"string"},"mime_type":{"type":"string"}},"required":["download_url","file_id"],"type":"object"}},"additionalProperties":false,"description":"Input schema for  ⟨42 unchanged words⟩ "maxItems":10,"type":"array"},"board_id":{"description":"The open Shoot Board's board_id, from Open Shoot Board or your context.","type":"string"},"build":{"default":null,"description":"Optional ⟨46 unchanged words⟩ ,"type":"integer"},"image_file_1":{"$refadditionalProperties":"#/$defs/OpenAIFile"false,"description":"Host-provided uploaded file reference for  ⟨15 unchanged words⟩  the host, not a bare file_... ID.","properties":{"download_url":{"type":"string"},"image_file_10file_id":{"$reftype":"#/$defs/OpenAIFilestring"},"file_name":{"type":"string"},"mime_type":{"type":"string"}},"required":["download_url","file_id"],"type":"object"},"image_file_10":{"additionalProperties":false,"description":"Host-provided uploaded file reference for the  ⟨14 unchanged words⟩  the host, not a bare file_... ID.","properties":{"download_url":{"type":"string"},"image_file_2file_id":{"$reftype":"#/$defs/OpenAIFilestring"},"file_name":{"type":"string"},"mime_type":{"type":"string"}},"required":["download_url","file_id"],"type":"object"},"image_file_2":{"additionalProperties":false,"description":"Host-provided uploaded file reference for the  ⟨14 unchanged words⟩  the host, not a bare file_... ID.","properties":{"download_url":{"type":"string"},"image_file_3file_id":{"$reftype":"#/$defs/OpenAIFilestring"},"file_name":{"type":"string"},"mime_type":{"type":"string"}},"required":["download_url","file_id"],"type":"object"},"image_file_3":{"additionalProperties":false,"description":"Host-provided uploaded file reference for the  ⟨14 unchanged words⟩  the host, not a bare file_... ID.","properties":{"download_url":{"type":"string"},"image_file_4file_id":{"$reftype":"#/$defs/OpenAIFilestring"},"file_name":{"type":"string"},"mime_type":{"type":"string"}},"required":["download_url","file_id"],"type":"object"},"image_file_4":{"additionalProperties":false,"description":"Host-provided uploaded file reference for the  ⟨14 unchanged words⟩  the host, not a bare file_... ID.","properties":{"download_url":{"type":"string"},"image_file_5file_id":{"$reftype":"#/$defs/OpenAIFilestring"},"file_name":{"type":"string"},"mime_type":{"type":"string"}},"required":["download_url","file_id"],"type":"object"},"image_file_5":{"additionalProperties":false,"description":"Host-provided uploaded file reference for the  ⟨14 unchanged words⟩  the host, not a bare file_... ID.","properties":{"download_url":{"type":"string"},"image_file_6file_id":{"$reftype":"#/$defs/OpenAIFilestring"},"file_name":{"type":"string"},"mime_type":{"type":"string"}},"required":["download_url","file_id"],"type":"object"},"image_file_6":{"additionalProperties":false,"description":"Host-provided uploaded file reference for the  ⟨14 unchanged words⟩  the host, not a bare file_... ID.","properties":{"download_url":{"type":"string"},"image_file_7file_id":{"$reftype":"#/$defs/OpenAIFilestring"},"file_name":{"type":"string"},"mime_type":{"type":"string"}},"required":["download_url","file_id"],"type":"object"},"image_file_7":{"additionalProperties":false,"description":"Host-provided uploaded file reference for the  ⟨14 unchanged words⟩  the host, not a bare file_... ID.","properties":{"download_url":{"type":"string"},"image_file_8file_id":{"$reftype":"#/$defs/OpenAIFilestring"},"file_name":{"type":"string"},"mime_type":{"type":"string"}},"required":["download_url","file_id"],"type":"object"},"image_file_8":{"additionalProperties":false,"description":"Host-provided uploaded file reference for the  ⟨14 unchanged words⟩  the host, not a bare file_... ID.","properties":{"download_url":{"type":"string"},"image_file_9file_id":{"$reftype":"#/$defs/OpenAIFilestring"},"file_name":{"type":"string"},"mime_type":{"type":"string"}},"required":["download_url","file_id"],"type":"object"},"image_file_9":{"additionalProperties":false,"description":"Host-provided uploaded file reference for the  ⟨14 unchanged words⟩  the host, not a bare file_... ID.","properties":{"download_url":{"type":"string"},"file_id":{"type":"string"},"file_name":{"type":"string"},"mime_type":{"type":"string"}},"required":["download_url","file_id"],"type":"object"},"image_url":{"default":null,"description":"Single ⟨27 unchanged words⟩ recovered avatar/model name","type":"string"}},"required":[],"type":"object"}

 ⟨5 unchanged words⟩ :true,"readOnlyHint":false,"title":"Upload AvatarsModels from Chat"}

Upload GarmentsClothing from URL

Queue a recoverable batchUpload uploadClothing from public HTTP(S) image URLsURLs. Queues a recoverable batch upload and returnreturns an operation immediately.immediately; Retryretry with the exact same arguments to read the stable operationits state;state retries(a doretry notcreates createno anothersecond upload.upload). DefaultsPhotos toare backgroundstored removal;as passuploaded, processing_mode='none'without tobackground storeremoval; originalprocessing_mode imagesis as-is.ignored. Prefer assets with {asset_kind: full|detail, asset_view: ⟨11 unchanged words⟩ 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.

 ⟨364 unchanged words⟩  image URL","type":"string"},"board_id":{"description":"The open Shoot Board's board_id, from Open Shoot Board or your context.","type":"string"},"description":{"default":null,"description":"Single item-level  ⟨140 unchanged words⟩ side image URL","type":"string"}},"required":[],"type":"object"}

 ⟨5 unchanged words⟩ :true,"readOnlyHint":false,"title":"Upload GarmentsClothing from URL"}

 ⟨944 unchanged words⟩ "minimum":1,"type":"integer"},"outfit_id":{"default":null,"description":"Outfit reference. The generation uses the front image of every garment in the outfit, as if each were attached as clothing_item.","minimum":1,"type":"integer"},"side":{"default":null,"enum":[" ⟨7 unchanged words⟩ ","generation_result","location","avatar","clothing_item","outfit"],"type":"string"},"uploaded_file_id": ⟨261 unchanged words⟩ 

 ⟨12 unchanged words⟩ , ArtDirections, uploaded files, and generation results. This is a finder, not a recommender. Use thisshort beforekeyword openingqueries the(2 pickerto when5 thewords), userone describesconcept assetsper call, or savedan creativeexact directionname/SKU/ID. byEvery exactword name/SKUmust ormatch naturalfor languagelexical results; long sentences can return no lexical matches. A query describing one garment finds that garment, not complementary garments. Vector results stay close to the best match. Use this before opening the picker, e.g. 'SKU 42', 'urban art direction', 'summer  ⟨34 unchanged words⟩ use the returned art_direction_id in briefs. This combines indexedcurrent lexical matchingmetadata with maintained vector retrieval;retrieval. Interactive searches do not runrefresh separatethe substringindex. searches.indexed_count is always 0 here; it is not index coverage.

 ⟨6 unchanged words⟩  universal hybrid library search.","properties":{"exclude_clothing_item_ids":{"default":null,"description":"Exclude these garment IDs after ranking and before the result limit; other item types are unaffected.","items":{"type":"integer"},"maxItems":100,"type":"array"},"item_types":{"default":null,"description":"Optional ⟨45 unchanged words⟩ :"integer"},"query":{"description":"HybridShort retrievalkeyword query.query: Handles2 exactto names/SKUs/IDs5 andwords, natural-languageone visualconcept per call, or attributean intent.exact name/SKU/ID. Every word must match for lexical results, so long sentences can return no lexical matches. Describing a garment finds that garment, not pieces to pair with it.

 ⟨196 unchanged words⟩ ,"description":"Updated canonical garment category","enum":["activewear","baby_and_childrens_clothing","blouses","bodysuits","cardigans","corset_tops","hoodies","overshirts","polos","shirts","sweaters","sweatshirts","t_shirts","tank_tops","tunics","dresses","lingerie","maternity_clothing","mens_undergarments","one_pieces","outerwear","outfit_sets","pants","shorts","skirts","skorts","sleepwear_and_loungewear","socks","suits","swimwear","traditional_and_ceremonial_clothing","uniforms_and_workwear","wedding_and_bridal_party_dresses","clothing_accessories","costumes_and_accessories","handbag_and_wallet_accessories","handbags_wallets_and_cases","jewelry","shoe_accessories","shoes","other"],"type":"string"},"clothing_item_id":{"description" ⟨313 unchanged words⟩ 

 ⟨12 unchanged words⟩  or supplemental critique. Provide exactly one source: attachment_type together with attachment_id for a workspace record, generation_result_id for a Shoot Board generation, uploaded_file_id for ⟨41 unchanged words⟩ 

 ⟨10 unchanged words⟩  image using AI vision.","properties":{"attachment_id":{"default":null,"description":"ID of the workspace record to view. Supply together with attachment_type.","minimum":1,"type":"integer"},"attachment_type":{"default":null,"description":"Type of an attached workspace record. Supply together with attachment_id, without another image source.","enum":["uploaded_file","generation_result","clothing_item","outfit"],"type":"string"},"generation_result_id":{"default":null,"description":"ID ⟨119 unchanged words⟩ 

{"destructiveHint":truefalse,"idempotentHint":false,"openWorldHint":falsetrue,"readOnlyHint":false,"title":"Create Avatar from References"}

{"destructiveHint":false,"idempotentHint":false,"openWorldHint":falsetrue,"readOnlyHint":false,"title":"Create Location"}

{"destructiveHint":true,"idempotentHint":false,"openWorldHint":falsetrue,"readOnlyHint":false,"title":"Generate Avatar Reference"}

{"destructiveHint":falsetrue,"idempotentHint":false,"openWorldHint":falsetrue,"readOnlyHint":false,"title":"Improve Art Direction"}

 ⟨14 unchanged words⟩ "null"]},"generate_audio":{"description":"WhetherInclude toaudio generatein audiothe withdelivered video. False delivers a silent file; fixed-audio providers are muted after generation at the videosame credits.","type":["boolean","null"]} ⟨105 unchanged words⟩ 

{"destructiveHint":true,"idempotentHint":false,"openWorldHint":falsetrue,"readOnlyHint":false}

 ⟨465 unchanged words⟩ object"},"generate_audio":{"default":false,"description":"Include audio in the delivered video. False delivers a file with no audio stream; fixed-audio providers are muted after generation, without reducing native-generation credits.","type":"boolean"},"generation_result_parent_id":{"default" ⟨775 unchanged words⟩ 

{"destructiveHint":true,"idempotentHint":false,"openWorldHint":falsetrue,"readOnlyHint":false,"title":"Create Brief for Approval"}

{"destructiveHint":false,"idempotentHint":false,"openWorldHint":falsetrue,"readOnlyHint":false,"title":"Save Reference Images"}

 ⟨471 unchanged words⟩ object"},"generate_audio":{"default":false,"description":"Include audio in the delivered video. False delivers a file with no audio stream; fixed-audio providers are muted after generation, without reducing native-generation credits.","type":"boolean"},"generation_result_parent_id":{"default" ⟨635 unchanged words⟩ 

 ⟨465 unchanged words⟩ object"},"generate_audio":{"default":false,"description":"Include audio in the delivered video. False delivers a file with no audio stream; fixed-audio providers are muted after generation, without reducing native-generation credits.","type":"boolean"},"generation_result_parent_id":{"default" ⟨729 unchanged words⟩ 

{"destructiveHint":true,"idempotentHint":false,"openWorldHint":falsetrue,"readOnlyHint":false,"title":"Update Garment"}

{"destructiveHint":false,"idempotentHint":false,"openWorldHint":falsetrue,"readOnlyHint":false,"title":"Upload Avatars from Chat"}

{"destructiveHint":false,"idempotentHint":false,"openWorldHint":falsetrue,"readOnlyHint":false,"title":"Upload Garments from Chat"}

{"destructiveHint":false,"idempotentHint":false,"openWorldHint":falsetrue,"readOnlyHint":false,"title":"Upload Garments from URL"}

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":true,"title":"Analyze Image"}