Append Semantic Section
append_semantic_sectionAppends a semantic section with a heading and native paragraph, bullet, or callout blocks to an existing AFFiNE document, optionally placing it after a chosen section.
Instructions
Append a semantic section to an existing AFFiNE document by heading title and native block composition.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"docId": "<docId>",
"sectionTitle": "<sectionTitle>"
},
"name": "append_semantic_section"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| docId | Yes | AFFiNE document id. | |
| bullets | No | Bulleted items to append under the new section. | |
| callouts | No | Callout blocks to append under the new section. | |
| paragraphs | No | Paragraphs to append under the new section. | |
| workspaceId | No | AFFiNE workspace id. Omit only when AFFINE_WORKSPACE_ID is configured. | |
| sectionTitle | Yes | Heading text for the new semantic section. | |
| expectedRevision | No | Optional read_doc revision of this primary document. Reject stale content before writing. Covers document content, not workspace metadata; requires all writers to share one MCP server. | |
| afterSectionTitle | No | Optional existing section heading to append after. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | No | ||
| code | No | ||
| docId | No | ||
| error | No | ||
| noteId | No | ||
| details | No | ||
| blockIds | No | ||
| causeCode | No | ||
| retryable | No | ||
| workspaceId | No | ||
| sectionTitle | No | ||
| appendedCount | No | ||
| recoveryGuidance | No | ||
| sectionHeadingId | No | ||
| afterSectionTitle | No |