Skip to main content
GET
/
api
/
v1
/
vault
/
search
curl -X GET \
  "/api/v1/vault/search?grep=machine%20learning&glob=project/*.md" \
  -H "Authorization: Bearer alf_your_key_here"
{
  "raw": "project/ML Pipeline Redesign.md\nproject/Customer Segmentation Model.md\nproject/NLP Research Initiative.md"
}

Overview

Search your vault records by keyword (grep) or file pattern (glob). Returns matching records or file paths.

Query Parameters

glob
string
File glob pattern to match (e.g., person/*.md, **/*alice*.md).
grep
string
Text to search for in record content (case-insensitive).

Response

raw
string
Search results as text. If the output is structured JSON, it is returned directly instead.

Request Example

curl -X GET \
  "/api/v1/vault/search?grep=machine%20learning&glob=project/*.md" \
  -H "Authorization: Bearer alf_your_key_here"

Response Example

{
  "raw": "project/ML Pipeline Redesign.md\nproject/Customer Segmentation Model.md\nproject/NLP Research Initiative.md"
}