Vault

http://127.0.0.1:8787

http://127.0.0.1:8787/api/v1

Authorization: Bearer wok_xxx
X-API-Key: wok_xxx

curl -H "X-API-Key: wok_xxx" \
  "http://127.0.0.1:8787/api/v1/notes?limit=10"

[
  {
    "path": "Welcome.md",
    "title": "Welcome",
    "tags": ["welcome"],
    "updated_at": "2026-08-13T19:00:00.000Z"
  }
]

curl -X PUT \
  -H "X-API-Key: wok_xxx" \
  -H 'Content-Type: application/json' \
  -d '{"content":"# From the agent\n\nHello vault."}' \
  "http://127.0.0.1:8787/api/v1/notes/Agent/Generated.md"

{
  "path": "Agent/Generated.md",
  "title": "Generated",
  "content": "# From the agent\n\nHello vault.",
  "tags": [],
  "frontmatter": {}
}

curl -H "X-API-Key: wok_xxx" \
  "http://127.0.0.1:8787/api/v1/search?q=tag:idea&limit=5"

{
  "query": "tag:idea",
  "hits": [
    {
      "path": "Notes/Ideas.md",
      "title": "Ideas",
      "score": 4.2,
      "tags": ["idea"],
      "snippet": "..."
    }
  ]
}