accept_page_edit
ChatGPTUser-interface action: replace the original page with the reviewed proposed image. Requires a widget-only review capability and an unchanged source. Affects every book sharing the page. Costs 0 credits.
Overview
Turn an idea into a printable coloring book in conversation. Plan scenes, choose a visual style, and confirm the plan before generation. Open the finished book as a PDF and view individual page images. Refine the artwork with edit previews, compare the original and proposed versions, and accept or discard each change. Browse existing books and characters from your connected ColoringBookify account. Intended for creators, parents, and educators.
Tools
approve_confirmation
ChatGPTUser-interface action: approve and execute the exact displayed request once. Requires a widget-only approval capability. Can spend the displayed credits and overwrite an image for regeneration.
archive_character
ChatGPTArchive a reusable character. Costs 0 credits.
attach_page_to_book
ChatGPTAttach an existing ready page to a compatible book. Costs 0 credits.
cancel_confirmation
ChatGPTCancel an owned pending confirmation without spending credits.
delete_book
ChatGPTPermanently delete an owned book. Costs 0 credits.
delete_page
ChatGPTPermanently delete an owned page and detach it from books. Costs 0 credits.
detach_page_from_book
ChatGPTDetach a page from a book without deleting the page. Costs 0 credits.
discard_page_edit
ChatGPTUser-interface action: discard the proposed edit and retain the current page. Requires a widget-only review capability. No additional charge; the generated preview cost is not refunded.
execute_confirmation
ChatGPTStart the exact quoted generation only after the user explicitly confirms its scope and credit cost in chat. Pass the returned quote id and request_digest unchanged and quoted_credits as expected_credits. Charges once; retries of the same quote return the same operation. Never call for planning-only requests or treat silence as consent. Then wait_for_operation and retrieve the files.
get_account
ChatGPTGet the current plan, available credits, and API capabilities. Include account name and email only when the user asks to identify the connected account.
get_book
ChatGPTGet one owned book, ordered page identities, coloring-scene versus PDF numbering, source revisions, and export readiness without a widget. Use for conversational page selection and edits.
get_book_files
ChatGPTDeliver a ready book in chat without an embedded widget: returns its PDF and ALL page images by default, including covers, ownership and ending pages. Download and attach every pages[].file, not just coloring scenes; image_file_count is the number to transfer. Pass cumulative delivered_page_versions from successful earlier transfers to omit duplicates. Set include_images false only for an explicit PDF-only request. Never call show_book to complete delivery. Costs 0 credits.
get_book_pdf
ChatGPTGet a short-lived, owner-authorized download_url and MCP resource URI for the final printable PDF. Download the URL for binary bytes instead of serializing resources/read output as text. The page_size must match the book aspect. Costs 0 credits.
get_character
ChatGPTRead metadata for one owned reusable character. To display its reference image, call get_character_image.
get_character_image
ChatGPTRetrieve an existing character reference as a signed download_url and MCP resource link without a widget. Download and attach the actual file to your reply when the host supports files; otherwise provide the authorized link. Never claim an attachment or visible image from a URL alone. Costs 0 credits.
get_confirmation
ChatGPTRetrieve a saved quote or its already-started operation without a widget. Use to resume a conversation or review the exact current cost. Costs 0 credits.
get_operation
ChatGPTGet an asynchronous operation and refresh its stored status from existing results, including progress, charged/refunded credits, and safe errors. Costs 0 credits and never starts generation.
get_page
ChatGPTRead metadata for one owned page. To display its image, call get_page_image; metadata alone does not show a page.
get_page_edit
ChatGPTGet progress and review state for an owned proposed image edit. Costs 0 credits.
get_page_edit_image
ChatGPTRetrieve the original or proposed edit image for review in chat. Download and present both before asking whether to accept or discard. Costs 0 credits.
get_page_image
ChatGPTRetrieve an existing coloring page as a signed download_url and MCP resource link without a widget. Download and attach the actual file to your reply when the host supports files; otherwise provide the authorized link. Never claim an attachment or visible image from a URL alone. Costs 0 credits.
get_workspace
ChatGPTUser-interface data refresh and navigation. Returns workspace data without creating another chat card. Never generates images or consumes credits.
import_page
ChatGPTImport a finished JPEG, PNG, or WebP page created outside ColoringBookify. Costs 0 credits.
list_books
ChatGPTList owned book metadata for lookup or filtering. To show covers and browse visually, use show_books.
list_characters
ChatGPTLook up active or archived reusable character metadata. To show reference sheets, use show_characters once instead of fetching each image.
list_operations
ChatGPTList asynchronous generation operations and refresh their stored progress from existing results. Costs 0 credits and never starts generation. Poll get_operation until status is terminal.
list_pages
ChatGPTList standalone and book pages owned by the account.
list_print_formats
ChatGPTList every supported PDF trim size, compatible aspect, and recommended generation dimensions.
plan_book
ChatGPTPlan a book without generating images or spending credits. Return scenes, options, coloring-scene and total PDF page counts, and an exact expiring quote. Present the plan in chat and ask for confirmation. After explicit consent use execute_confirmation; do not call prepare_book_quote again. Costs 0 credits.
prepare_book_page_quote
ChatGPTPrepare an exact quote without generation or charge. Present it in chat; call execute_confirmation only after explicit user consent. Quote creation of a page for an existing book for explicit user approval. Optional source_image converts an attached photo directly into this page without creating a character. Generation costs exactly 1 credit after approval. May also assemble a missing back cover once the book has at least four coloring pages.
prepare_book_quote
ChatGPTPrepare a quote for an explicitly specified complete book without generating or charging. Use plan_book for idea-based planning. If a plan already returned a confirmation, execute that confirmation after consent instead of calling this tool. Present the quote in chat.
prepare_character_quote
ChatGPTPrepare an exact quote without generation or charge. Present it in chat; call execute_confirmation only after explicit user consent. Quote creation of a reusable character only when the user requests one. Do not use for photo-to-coloring-page requests; use prepare_page_quote with source_image instead. Character generation costs 1 credit after approval and does not create a coloring page.
prepare_character_regeneration_quote
ChatGPTPrepare an exact quote without generation or charge. Present it in chat; call execute_confirmation only after explicit user consent. Quote regeneration of an existing reusable character. Generation costs exactly 1 credit after approval; this call only saves a pending quote.
prepare_page_quote
ChatGPTPrepare an exact quote without generation or charge. Present it in chat; call execute_confirmation only after explicit user consent. Quote creation of a single coloring page for explicit user approval. For photo-to-coloring-page requests, pass the attached photo as source_image directly to this tool; do not create a reusable character first. After approval, generation costs exactly 1 credit and returns an asynchronous operation.
prepare_page_regeneration_quote
ChatGPTPrepare an exact quote without generation or charge. Present it in chat; call execute_confirmation only after explicit user consent. Quote regeneration of an existing page. Generation costs exactly 1 credit after approval; this call only saves a pending quote.
reorder_book_pages
ChatGPTReplace the ordered list of all pages in a book. Costs 0 credits.
replace_page_image
ChatGPTReplace a page image with a finished external JPEG, PNG, or WebP. Costs 0 credits.
request_page_edit
ChatGPTPrepare an exact quote without generation or charge. Present it in chat; call execute_confirmation only after explicit user consent. Prepare a 1-credit edit of a selected interior coloring page using its current image and the requested change. Present the exact quote and obtain confirmation in chat before generation. Original stays unchanged until the user accepts the proposed image.
restore_character
ChatGPTRestore an archived reusable character when the plan limit allows it. Costs 0 credits.
review_page_edit
ChatGPTAccept or discard an existing proposed edit after showing the original and proposal and obtaining the user's decision in chat. Pass review_revision from get_page_edit. Acceptance updates every listed affected book and rejects a changed source. Costs 0 additional credits; discarding a successful preview does not refund its generation cost.
revise_book_plan
ChatGPTRevise a pending book plan and replace its approval with a new exact quote. No images are generated. Existing approval becomes invalid.
show_book
ChatGPTOpen an embedded interactive book gallery ONLY when the user explicitly requests that gallery/viewer. Do not use after generation, for downloads, to announce completion, or merely because the user wants a book or its images. Use get_book_files to deliver all images and the PDF in chat. This tool creates an iframe; user_requested_gallery must attest to an explicit gallery request. Costs 0 credits.
show_books
ChatGPTDisplay an inline cover carousel only when the user explicitly asks to browse an interactive book library. Never use to complete generation or deliver book files; use get_book_files for that. Opens the newest books by default; optionally supply up to 12 owned book IDs after filtering list_books results. Clicking a cover opens its page viewer. Costs 0 credits.
show_characters
ChatGPTDisplay existing reusable character reference sheets together in one gallery. Prefer this for requests to see characters; do not call get_character_image for each character or download them merely to display the gallery. Accepts limit up to 100 but returns at most 12 previews per page. Use next_cursor when has_more is true; query.limit reports the effective page size. Omit limit for the default gallery. Does not generate images. Missing previews are identified individually. Costs 0 credits.
show_confirmation
ChatGPTDisplay an optional interactive confirmation card only when the user requests visual review. The normal workflow presents the quote and obtains confirmation in chat. Costs 0 credits.
show_page_edit
ChatGPTDisplay the original and proposed page image for comparison and the user's accept or discard decision. May show processing progress. Costs 0 credits.
update_book
ChatGPTUpdate book metadata or its reusable character selection. Costs 0 credits.
update_character
ChatGPTUpdate a character name or public preview setting. Costs 0 credits.
update_page
ChatGPTUpdate page metadata or reusable character selection. Costs 0 credits.
wait_for_operation
ChatGPTWait briefly for an existing operation. For books, return early with newly_ready_pages as images become ready: download and attach ALL returned files now, including covers, ownership and ending pages, report progress, then keep polling this same operation until ready_for_delivery and retrieve the final PDF with get_book_files. Pass cumulative delivery_key values only after successful image transfers to avoid duplicate downloads. Set include_page_images false for PDF-only requests or if the host cannot transfer images; continue polling for the PDF. Never restart generation after a timeout. Costs 0 credits.
Capabilities
WritesInteractive
Example Prompts
Click any prompt to copy it.
