addBlock
ChatGPTInsert markdown as new block(s) on an object. - When afterBlockId is set, insert immediately after that sibling (UUID from readObjectBlocks). - When afterBlockId is omitted or empty, insert at the beginning of the object's default blocks property. Discover block IDs with readObjectBlocks before using afterBlockId.
appendMDToObject
ChatGPTAppend markdown content to an existing object.
createObjectLink
ChatGPTCreate a clickable link for an object ID. Use in your response when: Citing or referencing specific objects in your answer; You want the user to easily navigate to mentioned objects.
createObjectViaMD
ChatGPTCreate a new object by object type (title or plural, e.g. "Page", "Books") using markdown. Required: Call getObjectTypeShape with the same objectType first. Include every writable property you intend to set using the exact frontmatterKey values returned. Markdown import uses the same pipeline as Public API POST /object/markdown. Required: Call getObjectTypeShape with the same objectType first. Use only the frontmatterKey values it returns for properties on that object type. Document shape: 1. Optional YAML frontmatter between --- lines (writable object properties). 2. Markdown body after the closing --- (block content — not frontmatter). The createObjectViaMD title argument is always merged into frontmatter as title: (overrides an existing title key). Body-only markdown (no --- block): the tool wraps your input as: --- title: "Your title" --- Optional heading Body paragraphs... If your markdown already starts with ---, only the title argument is injected/updated in that block; the rest is imported as-is. Avoid duplicating the title as a lone heading unless you want it removed during import when it matches the title property.
createPage
ChatGPTCreate a new page (Page object) with a title and markdown body.
createTask
ChatGPTCreate a new task (Task object) with a title, optional task properties (status, priority, date, deadline), and markdown notes body. For task frontmatter keys and label options when using createObjectViaMD, call getObjectTypeShape with objectType "Task" first.
deleteBlock
ChatGPTRemove one block by blockId (from readObjectBlocks). Nested child blocks are removed with it. Discover block IDs with readObjectBlocks first.
deleteObject
ChatGPTMove an object to trash. User has 30 days to restore it before it is permanently deleted.
getObjectContent
ChatGPTRetrieve content, of a specific object by its ID. Use when: - The snippet from searchNotes is not enough to answer the user prompt. - You want to retrieve the full content of the object for further analysis or reference. Input: object ID (e.g., { id: "NOTE/abc123" }). Returns markdown content.
getObjectTypeShape
ChatGPTReturns authoritative YAML frontmatter keys and value formats for an object type in this space. Call this before createObjectViaMD when you need to set properties accurately.
listObjectsByCollection
ChatGPTList objects belonging to a collection, with cursor pagination.
listObjectsByObjectType
ChatGPTList objects belonging to an object type, with cursor pagination.
listObjectsByTag
ChatGPTList objects with a tag, with cursor pagination.
readObjectBlocks
ChatGPTReturn the structured blocks map for an object (propertyId → block trees with block ids). Call this before updateBlock, deleteBlock, or addBlock so you use real block UUIDs from the response. Do not invent block ids.
saveToDailyNote
ChatGPTStore text within today's daily note
search
ChatGPTSearch the user's Capacities space for objects/notes matching a query. Returns object IDs with titles and details (snippet). Use getObjectContent to fetch the full content of a specific object/note.
updateBlock
ChatGPTRewrite one existing block from its blockId (from readObjectBlocks) plus markdown that describes exactly ONE block of the same kind. Block type cannot change. Discover block IDs with readObjectBlocks first. Prefer this over appendMDToObject when editing a single existing passage.
updateObjectViaMD
ChatGPTUpdate properties of an existing object by ID using YAML frontmatter. Markdown property updates use the same frontmatter pipeline as Public API PATCH /object/markdown. Recommended: Call getObjectContent or getObjectTypeShape first to see current property keys and formats. Document shape: 1. YAML frontmatter between --- lines with only the properties you want to change. 2. Body content after the closing --- is ignored (use appendMDToObject to add content). Partial updates: only include keys you want to change; properties you omit are left unchanged. Replace, not merge: For each key you include, the entire property value is replaced — values are not appended or merged. To add to a multi-value property (e.g. tags), pass the full new list: all existing values plus the one(s) to add. Example: if tags are currently Work and you want to add Personal, use tags: Work, Personal — not tags: Personal alone. Frontmatter-only input (no --- block): the entire string is parsed as YAML key-value pairs. Example: --- description: "Updated description" tags: Work, Personal title: "Renamed page" --- To clear a property, set its value to null or an empty string.
uploadFile
ChatGPTUpload a file from a publicly accessible HTTP or HTTPS URL to the current Capacities space.
addBlock
ClaudeappendMDToObject
ClaudecreateObjectLink
ClaudecreateObjectViaMD
ClaudecreatePage
ClaudecreateTask
ClaudedeleteBlock
ClaudedeleteObject
ClaudegetObjectContent
ClaudegetObjectTypeShape
ClaudelistObjectsByCollection
ClaudelistObjectsByObjectType
ClaudelistObjectsByTag
ClaudereadObjectBlocks
ClaudesaveToDailyNote
Claudesearch
ClaudeupdateBlock
ClaudeupdateObjectViaMD
ClaudeuploadFile
Claude
