analyze_gallery
ChatGPTQueue missing or failed photo/video analysis with the existing provider pipeline and quota rules. This starts paid processing and returns a durable job ID.
apply_edit_proposal
ChatGPTApply the caller-authored proposal to its original draft version, rejecting stale proposals. Retrying the same proposal is safe. Does not publish.
cluster_gallery
ChatGPTExecute your typed clustering plan using existing metadata and embeddings. Returns exact occurrence memberships and summaries. You choose section titles and arrangement; the internal assistant is never called.
complete_uploads
ChatGPTVerify reserved uploads and create original library assets idempotently. Processing and optional AI analysis have separate statuses.
create_folder
ChatGPTCreate a folder within the connected account’s library.
create_gallery
ChatGPTCreate a new private unpublished gallery. Publication requires a separate explicit action.
delete_assets
ChatGPTPermanently delete owned originals and variants from storage and every gallery using them. Use get_asset to review all gallery references first. This is distinct from hiding or removing occurrences.
delete_gallery
ChatGPTPermanently delete the identified owned gallery and served output, retaining library originals. Requires the exact gallery name and explicit user authorization.
dismiss_edit_proposal
ChatGPTDismiss a pending caller-authored proposal without changing the saved gallery.
duplicate_gallery
ChatGPTCopy an owned gallery into a new unpublished draft, reusing media originals and allocating new section/item IDs.
edit_gallery
ChatGPTApply one atomic batch to a saved draft: add/update/delete/reorder sections; add/move/reorder/remove photo occurrences; set_visibility (hide/show); set_cover; or update_gallery (title, description, theme). The edits schema specifies each operation and its fields. Use saved itemIds for existing occurrences and unique placeholder IDs for new sections/items. Preserve unrelated items and pass the version from get_gallery. Retry with the same idempotencyKey AND identical edits, including placeholder IDs. Use canonical IDs from the response. Does not publish.
fetch
ChatGPTResolve an authorized SPG gallery resource link to its current saved state. Use this for gallery references attached in the composer.
find_duplicate_groups
ChatGPTFind byte-identical files and conservative image duplicate candidates. Similar videos are never considered duplicates unless byte-identical. Returns evidence without hiding or deleting anything.
find_similar_assets
ChatGPTCompare existing embeddings to a selected occurrence without invoking a reasoning agent or analyzing originals.
get_account
ChatGPTRead the connected SPG account, permissions, storage plan and AI availability. No analysis is started.
get_asset
ChatGPTRead authorized media data directly, including cached analysis or original metadata. Missing analysis remains unknown; this never starts another agent.
get_edit_proposal
ChatGPTRead a saved proposal and exact typed operations for review.
get_gallery
ChatGPTRead a saved gallery with stable section IDs, photo occurrence itemIds, assetIds, hidden state and version. Layout changes require the returned version.
get_gallery_access
ChatGPTRead owner-only live viewer allowlist and current served access mode alongside the staged draft visibility.
get_gallery_activity
ChatGPTRead authorized gallery revision history, analysis progress and pending proposals without invoking an agent.
get_gallery_conversation
ChatGPTRead authorized persisted gallery discussion records on explicit request. This does not send a message or invoke either agent.
get_gallery_dataset_profile
ChatGPTRead the same deterministic dataset profile as the internal gallery organization pipeline: dates, location/quality/embedding coverage, counts and missing metadata.
get_gallery_status
ChatGPTRead lightweight draft, proposal, publication and analysis status. Does not run analysis or another agent.
get_import_job
ChatGPTRead the connected account’s durable attachment import progress and per-file results. No download credentials are returned.
get_job
ChatGPTRead the connected user’s durable analysis job progress and item failures.
get_profile
ChatGPTReturn the profile represented by the validated credentials. The opaque ID remains stable across token refresh and reconnection.
get_publication_status
ChatGPTRead the actual served-publication and background job state for an authorized gallery.
import_files
ChatGPTQueue a durable import of user-supplied ChatGPT image/video attachments. Returns a job ID immediately; poll get_import_job for per-file outcomes, then wait for asset readiness before inserting. Does not publish or invoke the internal assistant.
inspect_photos
ChatGPTDeliver actual authorized photo previews to the model, labeled by asset ID. Use this for visual comparison; iframe thumbnails alone do not give the model visual access. Videos require their sampled analysis or poster.
list_assets
ChatGPTRead owned original media with optional filename, caption and folder filters. Returns a bounded page.
list_folders
ChatGPTList account-owned folder placeholders and paths within a requested folder, with pagination.
list_galleries
ChatGPTList galleries this account owns or has explicit access to. Returns saved draft versions; use get_gallery to edit one.
list_gallery_items
ChatGPTRead a page of photo/video occurrences in a gallery or section, including hidden items when requested.
list_gallery_revisions
ChatGPTList saved layout revisions and restoration points.
list_sections
ChatGPTList persistent sections in their saved order, including item counts.
move_assets
ChatGPTMove owned assets into an account-relative folder.
open_workspace
ChatGPTOpen the gallery workspace to browse galleries and edit photos visually. Accepts empty arguments when opened from navigation.
prepare_uploads
ChatGPTReserve account storage and obtain short-lived upload destinations for selected local files. Send file bytes directly to each destination, then call complete_uploads. Does not run AI analysis.
preview_visibility
ChatGPTExecute your typed visibility plan with the same quality, diversity, duplicate and semantic rules as the internal assistant. Returns proposed occurrence changes only; leaves the saved gallery untouched.
propose_gallery_edit
ChatGPTSave your typed edit proposal against the current gallery version. You supply the decisions and explanation; no internal agent is called and the draft is unchanged until apply.
publish_gallery
ChatGPTPublish the explicit saved gallery version. This changes the served gallery; access remains as configured. Returns real publication status.
rename_asset
ChatGPTRename an owned asset using the existing storage operation.
rename_folder
ChatGPTRename an owned library folder and its contents using the shared storage operation.
restore_gallery_revision
ChatGPTRestore a selected saved layout as a new draft revision. Does not restore deleted originals or republish the gallery.
retry_job
ChatGPTRetry a failed analysis job under the same permissions and allowance rules.
search_assets
ChatGPTFind photos/videos matching a semantic query within an explicit gallery, section or selection. Uses existing image embeddings and one query embedding; does not run the internal assistant or analyze originals.
search_mentions
ChatGPTRead-only typeahead for authorized galleries and sections.
set_gallery_parent
ChatGPTSet or clear the parent gallery within the connected owner’s galleries. Rejects cyclic nesting.
show_gallery
ChatGPTDisplay an identified gallery in the interactive editor. Use get_gallery first to identify the saved gallery and its version.
update_asset_caption
ChatGPTChange an owned original’s caption. The caption is shared by all galleries using that asset.
update_gallery_access
ChatGPTStage the owner’s access mode for the next explicit publication. Optional viewerEmails replaces the live sign-in allowlist immediately. Never infer public access or new viewers from an ambiguous sharing request.
update_gallery_settings
ChatGPTUpdate saved draft title, description, theme, thumbnail size, customization and slug. Does not publish. Slug changes take effect on the next publication.