photo_site_chat_choose_photos
ChatGPTUse this when attached photographs lack both downloadable file grants and readable local paths, or the user wants to choose photos from their device. Opens a focused photo-upload card for the saved site_id. Choosing files uploads them to the draft; this does not publish. After the user finishes, get the site and preview it in chat. Do not ask the user to reattach the same inaccessible inline images. Supply this site's private edit_token retained from its creation.
photo_site_chat_get
ChatGPTUse this when the user wants to recover, inspect, or preview a saved photography site in chat. Supply its private edit_token; site_id is optional because each key belongs to one site. Returns saved copy, theme, publication status, a signed draft page URL, and up to three optimized thumbnail images without changing or publishing the site. Supply this site's private edit_token retained from its creation.
photo_site_chat_prepare_local_upload
ChatGPTUse this when a Codex user explicitly asks to upload an attached local photograph without opening a web UI. Supply its site_id, actual filename, supported MIME type and exact byte size. Returns a five-minute, single-use upload URL. The agent must then transfer the local file bytes with the bundled upload-local.mjs helper; do not send local paths as download URLs. Not needed when ChatGPT supplies downloadable file grants. Supply this site's private edit_token retained from its creation.
photo_site_chat_publish
ChatGPTUse this only when the user explicitly asks to publish their saved photography site to its public or password-protected spaces.pics address. Publishing makes the optimized photographs externally reachable according to the chosen access mode. After success, give the user the returned recovery_key and ask them to save it so they can edit the site later. This tool returns text and structured data only; it never opens the web UI. Supply this site's private edit_token retained from its creation.
photo_site_chat_save
ChatGPTUse this when the user explicitly wants to save their site content, chosen theme, galleries, privacy mode, or chosen address. This does not publish the site. An existing address can be changed at most three times. This tool returns text and structured data only; it never opens the web UI. Supply this site's private edit_token retained from its creation.
photo_site_chat_start
ChatGPTUse this when beginning a new photography site in chat. Ask for the user’s site title first and pass it as title; the server generates an available title-based address automatically. Without title, returns the question to ask and does not create a draft. Do not invent a title. Does not save, upload or publish. Optional photos accepts only real downloadable file grants.
photo_site_chat_unpublish
ChatGPTUse this only when the user explicitly asks to take their photography site offline. Saved content and optimized photographs remain available to the owner for later editing or republishing. This tool returns text and structured data only; it never opens the web UI. Supply this site's private edit_token retained from its creation.
photo_site_chat_upload
ChatGPTUse this when the user explicitly wants to add selected photographs to their saved site. Specify site_id to select the saved site. Accepts JPEG, PNG, WebP, or AVIF files up to 20 MB each; stores only optimized WebP variants, strips GPS from metadata, and never retains originals. This tool returns text and structured data only; it never opens the web UI. Supply this site's private edit_token retained from its creation.
photo_site_chat_upload_device_bytes
ChatGPTUse this from the photo upload card after the user selects and uploads a device photograph. Pass its saved site_id, filename, MIME type, exact byte size and base64 bytes. Accepts one photograph up to 20 MB; stores optimized variants only and never publishes. Not for text, remote URLs or filesystem paths. Supply this site's private edit_token retained from its creation.
photo_site_check_slug
ChatGPTUse this when the user wants to check whether a specific spaces.pics subdomain is available. It accepts letters, numbers, and internal hyphens and does not reserve the address.
photo_site_create_attachment_previews
ChatGPTUse this when photographs chosen from ChatGPT need first-party previews. Immediately creates short-lived optimized previews without storing original files.
photo_site_delete_photo
ChatGPTUse this only when the user explicitly asks to permanently remove one uploaded photograph and both of its optimized variants. It does not affect the original source file in ChatGPT. Supply this site's private edit_token retained from its creation.
