Files
MultiPhysicsVault/skills/wiki/references/rest-api.md
T
김경종 72dad72703
Tests / Hermetic test suite (push) Has been cancelled
Tests / Skill frontmatter validation (push) Has been cancelled
add claude-obsidian
2026-05-28 10:57:16 +09:00

125 lines
2.1 KiB
Markdown

# REST API Quick Reference
Use these commands when MCP tools are not available. Requires the Local REST API plugin running in Obsidian (port 27124).
Set your key before running any command:
```bash
API="https://127.0.0.1:27124"
KEY="your-api-key-here"
```
---
## Read a file
```bash
curl -sk \
-H "Authorization: Bearer $KEY" \
"$API/vault/wiki/index.md"
```
---
## Create or replace a file
```bash
curl -sk -X PUT \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: text/markdown" \
--data-binary @local-file.md \
"$API/vault/wiki/entities/Name.md"
```
Or with inline content:
```bash
curl -sk -X PUT \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: text/markdown" \
--data "# Page Title
Content here." \
"$API/vault/wiki/concepts/Name.md"
```
---
## Append to a file
```bash
curl -sk -X POST \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: text/markdown" \
--data "- New log entry" \
"$API/vault/wiki/log.md"
```
---
## Patch a frontmatter field
```bash
curl -sk -X PATCH \
-H "Authorization: Bearer $KEY" \
-H "Operation: replace" \
-H "Target-Type: frontmatter" \
-H "Target: status" \
-H "Content-Type: application/json" \
--data '"mature"' \
"$API/vault/wiki/concepts/Name.md"
```
---
## Append content under a heading
```bash
curl -sk -X PATCH \
-H "Authorization: Bearer $KEY" \
-H "Operation: append" \
-H "Target-Type: heading" \
-H "Target: Connections" \
-H "Content-Type: text/markdown" \
--data "- [[New Page]]" \
"$API/vault/wiki/entities/Name.md"
```
---
## Search
Simple keyword search:
```bash
curl -sk -X POST \
-H "Authorization: Bearer $KEY" \
"$API/search/simple/?query=machine+learning"
```
Dataview query:
```bash
curl -sk -X POST \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: application/vnd.olrapi.dataview.dql+txt" \
--data 'TABLE status FROM "wiki" WHERE status = "seed"' \
"$API/search/"
```
---
## List all tags
```bash
curl -sk \
-H "Authorization: Bearer $KEY" \
"$API/tags/"
```
---
## List files in a folder
```bash
curl -sk \
-H "Authorization: Bearer $KEY" \
"$API/vault/wiki/entities/"
```