create_document
Create a new knowledgebase document with Markdown content, saved as a draft by default or published instantly when requested, and get back the document ID.
Instructions
Create a new document in the Meet Rupert knowledgebase. Provide the body as Markdown; it is converted to the platform's rich-text format. By default the document is saved as a DRAFT (not searchable by the AI) so a human can review it before publishing — pass published:true to make it live immediately. Returns the new document's id. To embed images, upload each one with create_attachment (which takes a file path or an https:// URL — never image data) and place the markdownRef it returns in content. Every attachment:// reference is verified before saving: if one is unknown or belongs to another workspace the save fails naming the offending id, rather than storing a broken image.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | The document title (1–255 characters). | |
| content | Yes | The document body as Markdown (headings, lists, bold/italic, code blocks are supported). To include an image, call create_attachment first — passing it a file path or URL — and put the markdownRef it returns on its own line here. Never paste image data, base64 or a data: URI into this field; it will not render and large values are silently truncated in transit. | |
| published | No | If true, the document is published and becomes searchable by the AI. Defaults to false (saved as a draft for a human to review and publish). | |
| categoryIds | No | Optional list of category UUIDs (from list_categories). On create/update, tags the document. On ask tools, restricts retrieval to these categories. |