Swish Sports Court Builder

Use this first when the user asks to create a sports court. One call saves and configures the design, shows its requested 2D/3D preview card, and returns builderUrl to continue editing. Supply simple fields directly; no control lookup needed for width, length, hoops or colors. Court types: fiba, nba, ncaa, usahs, tennis, pickleball, padel, volleyball, futsal, netball, racquetball, shuffleboard. Colors accept exact hex codes or builder swatch names. Preserve default flooring unless requested; report returned actual dimensions if tiles round the requested size. Optional actions support advanced controls. Do not call render/show/link again after success. Does not create an order.

create_court_design

Use this to change any discovered builder control using its current control ID: set inputs/selects/checkboxes, click buttons or open advanced rows, or drag within an identified canvas/control using normalized coordinates. Actions run through the real builder handlers. A failed batch is discarded. Supply a unique operationId UUID and expectedRevision; retry the same operation with the same ID.

edit_court_design

Use this when the customer wants to save or download the design. Images return a file. Videos run as background jobs: keep the returned jobId and call this tool again after retryAfterSeconds with the same designHandle, mode and jobId until status is completed or failed. Never claim the video is ready before downloadUrl is returned. A failed job can be retried with retry=true. For video, first discover and set share camera, rotation, duration, measurements and quality controls. Exports preserve their revision even if the design is edited later. This does not alter the saved design or place an order.

export_court_design

Use this when a specific advanced control or unknown option is needed. Basic creation accepts dimensions, hoops and colors directly and does not need this lookup. Initial catalogs are cached. For a saved design always supply designHandle to read its current controls. Search with query; page only relevant matches. Includes Add more sports, detail colors, borders, logos, text, camera and all advanced settings. Multi-court is excluded.

get_court_options

Use this to give the customer a link to continue editing or ordering in the normal Swish storefront. Prepares the builder’s original artwork/font uploads and share link. The resulting link shares this design and its artwork; it does not expose the private API editing handle or place an order.

create_court_link

Use this to inspect a saved design, actual dimensions, all settings, artwork and the current revision before making changes.

get_court_design

Use this for an image-only preview or a widget 2D/3D switch. For a visible ChatGPT card after edits use show_court_design instead. Creation already returns a preview. Unchanged revisions reuse the existing image. New previews are stored at unlisted public image URLs.

render_court_design

Use this once after advanced edits to display a saved court inside ChatGPT. Creation already displays this card. Do not call render_court_design first: this tool renders if needed and reuses existing images. The card provides 2D/3D buttons, an editing link and court specifications. Set mode to the view the user requested. New previews are stored at unlisted public image URLs.

show_court_design

Use this when the user provides logo images or a custom font. Read the design options to identify the appropriate file input control, then upload the supplied files. Use Add more logos first when adding a new logo rather than replacing an existing one. Original files are preserved with the design.

upload_court_files