add_prompts_to_view
ChatGPTAdd prompts to a view. A prompt is tracked once per answer engine and persona, so addedCount counts those memberships and one prompt can add several. Prompts from other products are skipped, and prompts already in the view are not added twice.
approve_content_draft
ChatGPTApprove one review draft, by ID, and queue it for publishing on the product's live site. Meant for a draft the user has named and confirmed.
approve_prompt_suggestions
ChatGPTApprove prompt suggestions. Approval creates tracked prompts and conversation queries and may change future Share of Voice results. Meant for suggestions the user has confirmed.
cancel_content_generation
ChatGPTStop a content generation that is still running.
create_content_draft
ChatGPTCreate a new content draft for this product from title and text the user already wrote. It goes to review, not live.
create_product
ChatGPTCreate a product in a TPC organization. Unless skipAutoContext is true, TPC fetches the public website at domain to generate product context.
create_prompt
ChatGPTCreate a prompt for one TPC product so it can be tracked across answer engines.
create_prompt_topic
ChatGPTCreate a prompt topic for a product. Topic titles are unique within a product. A new topic has no prompts.
create_tracked_url
ChatGPTStart tracking a URL for a product's citation analytics. Adding a URL that was tracked before and then deleted restores it. Tracked URLs are pages the team chose to monitor. They are not the cited sources from explore_analytics with metric=citations, nor crawled research seeds.
create_view
ChatGPTCreate a view for a product, optionally holding prompts from the start. Prompts from other products are skipped.
delete_content
ChatGPTDelete one page or draft, by ID. A deleted live page is archived and can be restored; a deleted review draft is gone permanently. It only removes pages and drafts, not the product, its organization, or its knowledge files. Meant for an item the user has named and confirmed.
delete_prompt
ChatGPTArchive one prompt, by ID. Prompts cannot be permanently deleted, and the product, its organization, and its knowledge files are not affected. Meant for a prompt the user has named and confirmed.
delete_prompt_topic
ChatGPTArchive a prompt topic. A topic that still has prompts is refused with its prompt count unless detachPrompts is true, which leaves those prompts without a topic. Prompts are never deleted.
delete_tracked_url
ChatGPTStop tracking a URL for a product. Adding the same URL again restores it. Tracked URLs are pages the team chose to monitor. They are not the cited sources from explore_analytics with metric=citations, nor crawled research seeds.
explore_analytics
ChatGPTRun one analytics query for this product: share of voice, citations, AI or human traffic, or sentiment, with at most one grouping dimension. For metric=sov when dimension is omitted or dimension=date, sov, mentions, and runs are trailing-30-day snapshot values. Without dimension, only the latest available snapshot in the requested window is returned; dimension=date returns one snapshot per date. The window selects eligible snapshot dates; it is not a period aggregation. Mentions and runs in dated rows come from overlapping rolling windows, so they do not add up across dates.
generate_content_drafts
ChatGPTWrite new content drafts from the given prompts. They go to review, not live.
generate_prompt_suggestions
ChatGPTGenerate a fresh batch of prompt suggestions. Replaces the current library for the selected product or topic.
get_content
ChatGPTOpen one page or draft and read its full text. The list leaves out body text by default.
get_knowledge_file
ChatGPTRead one file from this product's TPC knowledge base by path and return its full text.
get_product
ChatGPTRead one product's full details: description, keywords, differentiators, competitors, and product context.
get_view
ChatGPTRead one view with the prompts it holds and the answer engines each prompt is tracked on in the view.
list_content
ChatGPTSee the pages on this product and drafts waiting for review. Filter by live vs in review, search, or a prompt. Returns titles and paths by default, and draft text when includeContent is true.
list_knowledge_files
ChatGPTList the files in this product's TPC knowledge base as a Unix-style tree, optionally only those under a path prefix.
list_organizations
ChatGPTList the TPC organizations you belong to, with each one's name, slug, and ID. Each slug is an organizationSlug value that the other tools accept. Searchable by name or slug.
list_products
ChatGPTList products in a TPC organization as compact rows: ID, slug, name, domain, and a short description. Each slug or ID is a productSlug value that the product tools accept.
list_prompt_suggestions
ChatGPTList generated prompt suggestions for one TPC product. These are candidates, not yet tracked prompts.
list_prompt_topics
ChatGPTList a product's prompt topics, the groups its prompts are organized into, with each topic's count of prompts that have runs. Prompts with no runs are not counted, so a topic can list 0 and still hold prompts. A prompt belongs to at most one topic. Topic win or loss against competitors comes from list_topic_status.
list_prompts
ChatGPTList managed prompts for one TPC product and show them in the prompt-list widget. Filter by search, topic, category, keywords, or dates.
list_topic_status
ChatGPTList each prompt topic's competitive status for this product, the same labels as the Topic rankings card on the TPC dashboard. A topic is winning (the product ranks #1), contested (a competitor ranks #1 and the product is ranked), opportunity (a competitor ranks #1 and the product is not ranked), or unranked (no ranking data yet). It shows which topics the product is winning or losing to competitors; each topic includes the leader, the product's own rank and share of voice, and the top ranked products. Rankings cover the trailing 30 days ending on asOf, and the result includes that window.
list_tracked_urls
ChatGPTList a product's tracked URLs ranked by how often answer engines cite them, with summary metrics: total tracked, citation rate, top category, and total citations. New and edited URLs appear here a few seconds after the change. Tracked URLs are pages the team chose to monitor. They are not the cited sources from explore_analytics with metric=citations, nor crawled research seeds.
list_views
ChatGPTList a product's views, newest first. A view is a named group of the product's prompts that analytics can be filtered to. Each view belongs to one product.
publish_content
ChatGPTPublish one approved draft, by ID, to the product's live site, where anyone can see it. Meant for a draft the user has named and confirmed.
put_knowledge_file
ChatGPTWrite one file in this product's TPC knowledge base. put creates the file, or replaces it when the path already exists, on the live default branch. schema.md is readable but cannot be written.
reject_content_draft
ChatGPTSend a review draft back with a reason.
reject_prompt_suggestions
ChatGPTReject prompt suggestions, optionally recording a reason. Meant for suggestions the user has confirmed.
remove_prompts_from_view
ChatGPTRemove prompts from a view, including prompts that were archived. The prompts themselves are not changed.
restore_content
ChatGPTBring an archived live page back. Deleted review drafts cannot be restored.
revise_content_draft
ChatGPTReplace a review draft's text, or send feedback so the draft is rewritten.
unpublish_content
ChatGPTTake one live page, by ID, off the product's site and back to review. Meant for a page the user has named and confirmed.
update_content
ChatGPTEdit a live page's copy, path, or settings. Review drafts cannot be edited this way.
update_product
ChatGPTChange a product's name, domain, description, keywords, differentiators, or competitors. Omitted fields stay as they are.
update_prompt
ChatGPTChange a prompt's text, topic, category, keywords, sources, or metadata, or add or remove the answer engines it is tracked on.
update_prompt_suggestion
ChatGPTEdit a prompt suggestion's message, persona, or answer engines before approval.
update_prompt_topic
ChatGPTRename a prompt topic or change its description. Omitted fields stay as they are. null clears the description. The title cannot be cleared.
update_tracked_url
ChatGPTChange a tracked URL's address, title, description, or category. Omitted fields stay as they are. null clears the title or description and resets the category to other. The address cannot be cleared. Tracked URLs are pages the team chose to monitor. They are not the cited sources from explore_analytics with metric=citations, nor crawled research seeds.
update_view
ChatGPTRename a view, change or clear its description, or make it the product's default view. Making a view the default clears the flag on the product's other views. Omitted fields stay as they are.
