siyuan

Manage SiYuan blocks and documents via curl using the kernel API.

Updated Jun 28, 2026
One-click install
npx skills add https://github.com/jleechanorg/hermes-agent --skill siyuan-jleechanorg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: siyuan
Source: https://github.com/jleechanorg/hermes-agent/tree/main/optional-skills/productivity/siyuan
Command: npx skills add https://github.com/jleechanorg/hermes-agent --skill siyuan-jleechanorg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

SiYuan Note API access via curl enables programmatic control over blocks and documents in a self-hosted knowledge base, removing manual editing and repetitive tasks.

Core Features & Use Cases

  • Search, read, create, update, and delete blocks and documents via SiYuan API to manage notes across notebooks.
  • Programmatic workflows for PKM, knowledge base maintenance, and rapid content organization using curl.
  • Integrations with scripts and automation to keep knowledge bases in sync with other tools.

Quick Start

Use curl with the SiYuan API to search, read, create, update, and delete blocks and documents in your self-hosted knowledge base.

Frequently Asked Questions about siyuan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage SiYuan notes via the API?

Manage SiYuan notes via the API by sending curl POST requests to search, read, create, update, and delete blocks and documents across your notebooks.

Can I create and update SiYuan blocks using curl?

Yes, you can create and update SiYuan blocks using curl by sending POST requests to the SiYuan kernel API endpoints for programmatic document modification.

Do I need an API token to access the SiYuan kernel?

Yes, accessing the SiYuan kernel requires a running SiYuan instance, a valid API token, and the instance URL to authenticate your curl POST requests.

What is the best way to automate knowledge base maintenance in SiYuan?

Automate SiYuan knowledge base maintenance by integrating curl scripts with the SiYuan API to programmatically organize content and keep notebooks in sync with other tools.

Why does my SiYuan API curl request fail to execute?

SiYuan API curl requests fail if they do not use POST endpoints for every operation, or if the provided API token and self-hosted instance URL are invalid.

Does the SiYuan API support deleting documents programmatically?

Yes, the SiYuan API supports deleting documents and blocks programmatically through curl POST requests to manage your self-hosted knowledge base workflows.