Carryo

Use this when the user wants to add, swap, or remove images on an already-published page without rewriting its HTML. Provide path and a fetchable http(s) sourceUrl per image; never read image bytes or use base64 or data URLs. If no fetchable URL exists, stop and ask the user for one. Afterwards call update_artifact only if the page HTML must reference the returned assetUrl.

upsert_artifact_assets

Use this when the user wants the page to stay private for now, wants restricted access, or wants to review settings before anything goes live. Creates a private Carryo draft and returns a Carryo management URL, not a public viewer URL; the page stays inaccessible until the user publishes it from Carryo. Never collect access secrets in ChatGPT. Images follow the same rules as share_artifact: matching assets entries with fetchable http(s) sourceUrl, never base64 or data URLs. Do not use for pages that collect viewer data or request restricted sensitive personal data.

create_artifact_draft

Use this when the user asks about their Carryo plan, limits, remaining links, or optional link features. Check features.customUrlSlug before offering a custom URL ending. Read-only; changes nothing.

get_account_status

Use this when you need the current HTML of a page the user already published or drafted on Carryo, before editing it with update_artifact, or when the user asks what a link currently contains. Returns asset descriptors for bundled images, not the asset bytes.

get_artifact_content

Use this when the user has picked a specific historical version to view, compare, or restore. Returns that version of the page HTML. For normal edits use get_artifact_content for the live version instead.

get_artifact_version_content

Use this when the user asks to see, find, or manage what they've published, such as 'show my links', 'what have I published with Carryo?', or 'find my pricing page', or whenever you need a linkId and the user referred to a page by name instead of ID. Returns the user's Carryo links with titles, URLs, and status.

list_shared_artifacts

Use this when the user asks about previous versions, what changed, or wants to roll back a published page. Lists version metadata only; for normal edits use get_artifact_content for the live version instead.

list_artifact_history

Use this when the user wants to publish, share, host, deploy, or put online an AI-created HTML page from this conversation, including presentations, slide decks, proposals, reports, landing pages, dashboards, invitations, portfolios, or one-page websites. Creates a public Carryo live link and returns the share URL. Ask whether the user wants a custom URL ending and pass it as customSlug when provided; otherwise omit customSlug. Images: reference relative paths such as images/photo.jpg in htmlContent and provide matching assets entries with path and a fetchable http(s) sourceUrl; never use base64 or data URLs. Do not use for non-HTML files, general file storage, backend app hosting, pages that collect viewer data, or pages requesting restricted sensitive personal data.

share_artifact

Use this when the user wants to unpublish, take down, disable, or delete a shared link. Revokes the Carryo link so viewers can no longer open it. This cannot be undone for the link, so confirm with the user before calling.

revoke_artifact

Use this when the user wants to edit, fix, or republish a page that already has a Carryo link while keeping the same URL. Read the current content with get_artifact_content first, then replace the HTML here. Add or replace bundled images via assets entries with path and a fetchable http(s) sourceUrl, never base64 or data URLs, and remove images with removeAssetPaths. Do not use for pages that collect viewer data or request restricted sensitive personal data.

update_artifact