SiYuan icon

SiYuan

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

Tag → Find Blocks by Tag

AI-generated

Overview

This node operation allows users to find blocks in SiYuan that are tagged with a specific tag name. It is useful for workflows that need to retrieve and process content blocks associated with particular tags, enabling efficient content organization and retrieval within SiYuan notebooks or documents.

Use Case Examples

  1. Finding all blocks tagged with 'important' to aggregate key information.
  2. Retrieving blocks tagged with a project-specific tag to generate reports or summaries.

Properties

Name Meaning
Tag The tag name (without the # symbol) used to find blocks associated with this tag.

Output

JSON

  • blockId - The unique identifier of the block found with the specified tag.
  • content - The content or data contained within the block.
  • tags - List of tags associated with the block.
  • metadata - Additional metadata related to the block, such as creation date or author.

Dependencies

  • Requires SiYuan API URL and API token credentials for authentication.

Troubleshooting

  • Ensure the SiYuan API URL and token are correctly configured; missing or invalid credentials will cause authentication errors.
  • If no blocks are found, verify the tag name is correct and exists in the SiYuan workspace.
  • Handle API rate limits or network issues that may cause request failures.

Discussion