add_brand_asset
ChatGPTAttach a completed font or logo upload to this brand, with an optional note on how to use it ("headlines only"). The owner's fonts and logos are always used first. Rebuilds asynchronously.
add_inspiration
ChatGPTAdd a completed PNG or PDF upload to this brand, with an optional note on how to use it. The owner's references are always used first. Rebuilds the environment asynchronously.
add_inspiration_file
ChatGPTImport a user-selected or conversation-attached PNG/PDF into a brand. Accepts the host-provided file object; do not invent attachment URLs. Verifies file type and size, then rebuilds the brand asynchronously. Reuse requestId on retries. Works without the visual picker.
begin_upload
ChatGPTGet a bounded, short-lived upload form for a PNG, PDF, logo or font. Upload exact bytes to the returned URL, then call complete_upload. No arbitrary remote URL import.
complete_upload
ChatGPTVerify a completed upload before adding it to a brand.
create_design
ChatGPTGenerate a branded asset using an existing brand and references. Template mode uses one reference for every page, or one per output page in order (each page of a multi-page PDF template). Inspiration mode uses the first reference as primary and up to three supporting references. Multiple pages require PDF. Returns a jobId and sessionId immediately; check get_job.
delete_inspiration
ChatGPTRemove this inspiration from the brand and rebuild its environment. Confirm the user intends to delete this reference.
edit_design
ChatGPTRevise an existing design session. Omitted mode, references and output dimensions inherit from its last accepted request. Keeps brand assets and editable source. To change words, name text areas in textEdits: a finished job (get_job) and its session list textAreas with id, page, text, box and role. Returns a new job.
get_brand
ChatGPTRead one brand kit: its name, colors, description and instructions. The fonts, logos and references the owner added are listed by list_brand_assets and list_inspirations.
get_inspiration
ChatGPTRead an uploaded reference by its inspiration ID (the resourceId of a completed add-inspiration job). Returns its file type and PDF page count. Use preview_inspiration for page images and pixel dimensions; show_brand with inspirationId selects it and suggests matching output dimensions.
get_job
ChatGPTCheck an asynchronous brand or design job. With wait=true the server follows the job for up to about 18 seconds and answers as soon as it finishes, so call it again while it is still running instead of waiting yourself. statusText says where the job is in plain words. Succeeded means verified exports were saved; failed/cancelled are terminal.
get_outputs
ChatGPTReturn completed PNG/PDF exports and fresh download links. Links expire after five minutes; call again to refresh. Never includes agent turns or HTML sources.
get_session
ChatGPTRead a session’s brand and accepted output settings.
list_brand_assets
ChatGPTList this brand’s uploaded fonts and logos.
list_brands
ChatGPTList the connected account’s brand kits. Pagination cursors are account-bound.
list_inspirations
ChatGPTList the PNG/PDF references the owner added to this brand. A PDF can supply multiple selectable pages. Use the first reference as primary in inspiration mode. References are optional in create_design: name none and the designer chooses from the brand's library, the owner's own references first.
list_sessions
ChatGPTFind previous sessions for this account to reopen or edit.
open_design_file
ChatGPTView a PNG or PDF opened by the host. The host supplies an opaque resource URI; never invent it or send a filesystem path. Reading stays in the host, and importing into a brand requires a user action.
open_design_panel
ChatGPTOpen brands, reference images and design files beside the conversation. Selections provide context for the next request.
open_library
ChatGPTBrowse the connected account’s brands, references and recent designs. Opens the native sidebar app. Describe new designs and edits in the conversation.
preview_inspiration
ChatGPTGet a short-lived PNG preview and rendered pixel dimensions for a selected inspiration page. PDFs are rasterized page by page; use these dimensions to suggest an output size with matching proportions.
refresh_design_view
ChatGPTReturn current preview data for app polling. This data-only tool does not redraw a model-invoked panel. After a conversational edit, call show_designs with the new jobId to present it. With sessionId, resolves the active or latest job.
setup_brand
ChatGPTCreate a brand kit from its public website domain. Setup runs asynchronously: returns a job; wait for success before generating. The brand can make designs as soon as it is ready, before the owner adds anything.
show_brand
ChatGPTDisplay the brand's own reference library (what the owner added) with Inspiration/Template selection, a large page preview and PNG/PDF uploads. With nothing selected, the designer chooses references itself. Selected references and output preferences become conversation context. When reopening a selection from conversation context, pass its mode, references and output unchanged so the panel preserves them. The user describes what to make in the main conversation. All actions also work through text; never require clicking this UI.
show_designs
ChatGPTDisplay the preview card for a jobId or sessionId returned by create_design, edit_design or get_outputs. The viewer polls jobs, displays PNG/PDF pages and offers downloads. The user edits by describing changes in the main conversation.
update_brand
ChatGPTUpdate brand name, colors or brand instructions. Rebuilds the brand environment asynchronously.