SiYuan icon

SiYuan

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

Block → Transfer References

AI-generated

Summary

Transfer block references from a source block to a target block, optionally specifying which reference IDs to transfer.

Inputs

  • From Block ID (required) — The ID of the block whose references will be transferred away.
  • To Block ID (required) — The ID of the block that will receive the transferred references.
  • Reference IDs — Optional comma-separated list of specific reference block IDs to transfer. If left empty, all references are transferred.

Output shape

an object containing the API response to the transfer request indicating success or failure

Returns the result of the transferBlockRef API call, which may vary depending on whether specific reference IDs are provided or all references are transferred. Errors are thrown for invalid block IDs or API failures.

Links

Discussion