apply_article_append
ChatGPTAppend structured blocks as a new draft revision while preserving the existing article JSON. The prepared token limits the destination to the authenticated user's private Inbox or a Workspace in their account where they have editor or admin access; authorization is checked again when applying. Saves a draft only. Does not publish content, send messages to external recipients, or access arbitrary external systems.
apply_article_create
ChatGPTCreate a prepared Markdown article as a new draft. Pass the same Markdown used for prepare_article_create and its create_token. The prepared token limits the destination to the authenticated user's private Inbox or a Workspace in their account where they have editor or admin access; authorization is checked again when applying. Saves a draft only. Does not publish content, send messages to external recipients, or access arbitrary external systems.
apply_article_replace
ChatGPTReplace one targeted block at any addressable depth as a new draft revision while preserving all other blocks. The prepared token limits the destination to the authenticated user's private Inbox or a Workspace in their account where they have editor or admin access; authorization is checked again when applying. Saves a draft only. Does not publish content, send messages to external recipients, or access arbitrary external systems.
apply_article_update
ChatGPTApply a prepared Markdown update as a new draft revision. The prepared token limits the destination to the authenticated user's private Inbox or a Workspace in their account where they have editor or admin access; authorization is checked again when applying. Saves a draft only. Does not publish content, send messages to external recipients, or access arbitrary external systems.
get_article
ChatGPTRead an article from the personal inbox by default, or an explicitly selected Workspace. Return source_url for citation.
get_article_snapshot
ChatGPTRead an article's structured blocks at any addressable depth with stable node IDs for targeted MCP edits.
list_articles
ChatGPTList articles in the personal inbox by default, or an explicitly selected Workspace, including source_url for each article.
list_inbox_folders
ChatGPTList the personal Inbox folder tree. Use folder_path for one subtree; depth may be a level count or all. Without depth, expand to level 2 or 3 only when cumulative folder counts meet expand_if_at_most budgets. Results are paginated.
list_inbox_tags
ChatGPTList existing personal Inbox tags, including catalog tags not currently attached to a note. Use before tagging a note to check names already in use.
list_workspaces
ChatGPTList Spaces workspaces available to the authenticated AI client, including workspace_url for linking.
prepare_article_append
ChatGPTValidate structured blocks to append to an article without rewriting its existing content.
prepare_article_create
ChatGPTValidate a new Markdown draft and return a short-lived token without saving. Put the article title only in front matter title; do not repeat it as a leading H1 or paragraph in the body. The first H1 is not extracted or removed. Preserve meaningful body headings and existing content outside the requested edit. space_revision_id is not needed for creation and is ignored if supplied. Default: personal inbox; omit space_workspace_slug in Markdown and use visibility private, draft true, locale ja, empty excerpt, and optional tags: ["tag"] to set Inbox tags. Specify workspace_slug for a Workspace; Workspace articles do not support tags.
prepare_article_replace
ChatGPTValidate replacement structured blocks for one article block at any addressable depth without rewriting other content.
prepare_article_update
ChatGPTValidate a full Markdown draft update and return a short-lived token without changing the article. Put the article title only in front matter title; do not repeat it as a leading H1 or paragraph in the body. The first H1 is not extracted or removed. Preserve meaningful body headings and existing content outside the requested edit. Personal Inbox Markdown may include tags: ["tag"] to add tags while keeping existing tags; omit tags or use tags: [] to leave them unchanged. Workspace articles do not support tags.
search_all_articles
ChatGPTSearch saved draft articles across every available workspace and return source_url for each result.
search_articles
ChatGPTSearch articles in the personal inbox by default, or an explicitly selected Workspace; return source_url for each result.