Write and manage documents

Create, edit, and organize Markdown documents with full revision history and file attachments.

  1. 1 Create a document

    Create documents from the UI or via MCP. Every document supports full Markdown with headers, lists, code blocks, and links.

    // Create a new document create_doc: { "workspace_id": "...", "title": "API Design Guide", "body_md": "# API Design\n\nOur conventions...", "type": "document" }

  2. 2 Edit with revision history

    Every edit creates a new revision. The full history is preserved — you can view and compare any previous version.

    // Update an existing document update_doc: { "workspace_id": "...", "doc_id": "...", "body_md": "Updated content..." }

  3. 3 Attach files

    Add images, PDFs, and diagrams to documents as attachments. Files are stored alongside the document and included in data exports.

  4. 4 Search and browse

    Search documents by title across your workspace. Use the command palette (Cmd+K) for instant results.

    // List recent documents list_docs: { "workspace_id": "...", "limit": 20 }

  5. 5 Archive documents

    Archive documents when they are no longer relevant. Archived documents are soft-deleted — they can be restored at any time and are preserved in data exports.

  6. 6 Follow the newsfeed

    Use the newsfeed to see recent document activity across your workspace. New documents, edits, and announcements appear in chronological order.

Tips

  • Every edit creates a new revision. Full history is preserved and accessible.
  • Documents export as plain Markdown files in data exports.
  • Use announcements to broadcast important documents to the workspace.
  • Link documents to tickets by referencing ticket keys in the body.

Next steps