create_block
Add new content blocks to document sections including paragraphs, code snippets, lists, and tables to organize and structure your documents effectively.
Instructions
Create new block in specified section.
**TIP: Block IDs are auto-generated, but you can identify blocks later by their content.
Consider adding meaningful content/titles to make blocks easier to find with get_outline().**
Args:
    project_id: Project identifier
    section_id: Section ID to add block to
    block_type: Block type - paragraph/code/list/table
    content: Content for paragraph/code blocks
    items: Items for list blocks
    language: Language for code blocks
    header: Header row for table blocks
    rows: Data rows for table blocks
    feature_id: Feature identifier (for RBT documents)
    doc_type: Document type - REQ/BP/TASK (for RBT documents)
    file_path: File path relative to docs/ (for general documents)
Returns:
    New block ID
Example:
    # Create paragraph
    create_block(
        project_id="knowledge-smith",
        file_path="docs/guide.md",
        section_id="sec-intro",
        block_type="paragraph",
        content="This is a new paragraph."
    )
    # Create list
    create_block(
        project_id="knowledge-smith",
        file_path="docs/guide.md",
        section_id="sec-features",
        block_type="list",
        items=["Feature 1", "Feature 2"]
    )
@REQ: REQ-rbt-mcp-tool
@BP: BP-rbt-mcp-tool
@TASK: TASK-009-CreateBlockTool
Input Schema
| Name | Required | Description | Default | 
|---|---|---|---|
| block_type | Yes | ||
| content | No | ||
| doc_type | No | ||
| feature_id | No | ||
| file_path | No | ||
| header | No | ||
| items | No | ||
| language | No | ||
| project_id | Yes | ||
| rows | No | ||
| section_id | Yes | 
Input Schema (JSON Schema)
{
  "properties": {
    "block_type": {
      "title": "Block Type",
      "type": "string"
    },
    "content": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Content"
    },
    "doc_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Doc Type"
    },
    "feature_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Feature Id"
    },
    "file_path": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "File Path"
    },
    "header": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Header"
    },
    "items": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Items"
    },
    "language": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Language"
    },
    "project_id": {
      "title": "Project Id",
      "type": "string"
    },
    "rows": {
      "anyOf": [
        {
          "items": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Rows"
    },
    "section_id": {
      "title": "Section Id",
      "type": "string"
    }
  },
  "required": [
    "project_id",
    "section_id",
    "block_type"
  ],
  "type": "object"
}