SiYuan icon

SiYuan

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

Block → Transfer References

AI-generated

Overview

This node operation transfers references from one block to another within the SiYuan note-taking system. It is useful when you want to reassign or consolidate references from a source block to a target block, either transferring all references or specific ones by their IDs. For example, if you have a block with outdated references and want to move those references to a new block, this operation facilitates that transfer efficiently.

Use Case Examples

  1. Transferring all references from Block A to Block B to consolidate information.
  2. Transferring specific reference IDs from one block to another to reorganize content.

Properties

Name Meaning
From Block ID The block whose references should be transferred away. This is the source block ID from which references will be moved.
To Block ID The block that should receive the references. This is the target block ID to which references will be assigned.
Additional Options Optional parameters for the transfer operation, including a comma-separated list of specific reference block IDs to transfer. If left empty, all references will be transferred.

Output

JSON

  • success - Indicates whether the transfer operation was successful.

Dependencies

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

Troubleshooting

  • Ensure that both 'From Block ID' and 'To Block ID' are valid and exist in the SiYuan workspace.
  • If specifying Reference IDs, ensure they are correctly formatted as a comma-separated string and correspond to existing references.
  • Common error: 'SiYuan API URL and Token are required.' means the credentials are missing or incorrect; verify API credentials setup.
  • Unsupported resource or operation errors indicate misconfiguration of the resource or operation parameters.

Discussion