SiYuan icon

SiYuan

Manage SiYuan notebooks, documents, blocks, attributes, and more. Designed for AI agent workflows.

Tag → Add

AI-generated

Summary

Add the supplied tag to a SiYuan block, preserving its existing tags. If the tag is already present, the operation leaves the tag list unchanged.

Inputs

  • Block ID (required) — Unique ID of the block to update.
  • Tag (required) — Tag name without the # symbol.

Output shape

A single record with blockId and tags.

tags is the block’s resulting tag list, including the requested tag. The operation reads the block’s current tag attribute and writes the updated list.

Examples

Example 1: Add a tag to a block

Provide the block ID and a tag name without #, such as project-planning.

Links

Discussion