create_artifact_draft
ChatGPTCreate a private Carryo draft for an HTML artifact and return a Carryo management URL, not a public viewer URL. Use this when the user wants restricted access or wants to review access settings in Carryo before publishing. The draft is not publicly accessible until the user opens manageUrl on Carryo, chooses access settings, and publishes it. Do not collect access secrets in ChatGPT. Do not use this tool for pages that collect viewer data or request restricted sensitive personal data. Fast path for images: reference a relative path in htmlContent such as images/photo.jpg and provide a matching assets entry with path and sourceUrl. Carryo imports and hosts images only from fetchable http(s) URLs. Never convert images to base64 or data URLs. If no fetchable attachment URL is available, stop and ask the user for a public or direct image URL.
create_artifact_draft
ChatGPTUse 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.
get_account_status
ChatGPTRead the authenticated Carryo account plan, limits, and available feature flags. Call this before offering optional account-gated settings, including custom URL endings; only ask for a custom URL ending when features.customUrlSlug is true.
get_account_status
ChatGPTUse 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_artifact_content
ChatGPTRead the current HTML content for an artifact you own. Returns asset descriptors for bundled images, but not the asset bytes themselves.
get_artifact_content
ChatGPTUse 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_version_content
ChatGPTRead the HTML content for a specific historical version of an artifact you own. Use only after choosing a historical version; normal edits should use get_artifact_content for the live/latest version.
get_artifact_version_content
ChatGPTUse 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.
list_artifact_history
ChatGPTList version history for an artifact you own. Use only when the user asks for prior versions, audit history, rollback context, or edit details; normal edits should use get_artifact_content for the live/latest version.
list_artifact_history
ChatGPTUse 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_shared_artifacts
ChatGPTList artifacts shared by the authenticated user.
list_shared_artifacts
ChatGPTUse 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.
revoke_artifact
ChatGPTRevoke a previously shared artifact link.
revoke_artifact
ChatGPTUse 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.
share_artifact
ChatGPTCreate a public shareable internet link for an HTML artifact. Do not use this tool for pages that collect viewer data or request restricted sensitive personal data. Before offering a custom URL ending for a new public Carryo link, call get_account_status; if features.customUrlSlug is true, ask whether the user wants a custom URL ending and pass it as customSlug when provided. If customUrlSlug is false or unavailable, omit customSlug and use the automatic URL. Fast path for images: reference a relative path in htmlContent such as images/photo.jpg and provide a matching assets entry with path and sourceUrl. Carryo imports and hosts images only from fetchable http(s) URLs. Never convert images to base64 or data URLs. If no fetchable attachment URL is available, stop and ask the user for a public or direct image URL.
share_artifact
ChatGPTUse 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.
update_artifact
ChatGPTReplace the HTML content of an existing artifact while keeping the same link. Do not use this tool for pages that collect viewer data or request restricted sensitive personal data. Use this tool to add or replace bundled images by passing assets with path and sourceUrl, and remove bundled images with removeAssetPaths. Carryo imports and hosts images only from fetchable http(s) URLs. Never convert images to base64 or data URLs. If no fetchable attachment URL is available, stop and ask the user for a public or direct image URL.
update_artifact
ChatGPTUse 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.
upsert_artifact_assets
ChatGPTFast path for hosted images on an existing artifact. Add, replace, or remove bundled images without changing the current HTML. Provide path and sourceUrl for each image. Carryo imports and hosts images only from fetchable http(s) URLs. Never read image bytes or convert images to base64 or data URLs. If no fetchable attachment URL is available, stop and ask the user for a public or direct image URL. After uploading, use update_artifact only if you want to reference the returned assetUrl in the page layout.
upsert_artifact_assets
ChatGPTUse 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.
