Skip to main content

​
Overview

Your vault grows with everything you share with Alfred. Here’s how to explore it — from your dashboard or via the API.

​
Dashboard vault browser

Your Alfred Black dashboard includes a vault browser where you can:
  • Filter by type — Use the dropdown to show only people, tasks, decisions, or any other record type
  • Search by keyword — Find records matching a search term
  • Click to view — Open any record to see its full content and connections

​
API methods

​
Get a vault overview

See a summary of your vault — how many records of each type, recent activity, and overall statistics. 
curl -s /api/v1/vault/context \
  -H "Authorization: Bearer alf_your_key_here" | jq .

​
List records by type

Browse all records of a specific type: 
curl -s /api/v1/vault/list/person \
  -H "Authorization: Bearer alf_your_key_here" | jq .
Replace person with any record type: task, project, decision, assumption, etc.

​
Search your vault

Find records matching a keyword or pattern: 
curl -s "/api/v1/vault/search?grep=Platform+v2" \
  -H "Authorization: Bearer alf_your_key_here" | jq .

​
Read a specific record

Get the full content of any record by its path: 
curl -s "/api/v1/vault/records/person/Alice%20Smith.md" \
  -H "Authorization: Bearer alf_your_key_here" | jq .

​
Example workflows

​
”Find everything about Project X"

# Search across all record types
curl -s "/api/v1/vault/search?grep=Project+X" \
  -H "Authorization: Bearer alf_your_key_here" | jq .

​
"See all open tasks"

curl -s /api/v1/vault/list/task \
  -H "Authorization: Bearer alf_your_key_here" | jq .

​
"Review recent decisions"

curl -s /api/v1/vault/list/decision \
  -H "Authorization: Bearer alf_your_key_here" | jq .

​
"What assumptions are we making?”

curl -s /api/v1/vault/list/assumption \
  -H "Authorization: Bearer alf_your_key_here" | jq .

Record Types

See all 22 record types

API Reference: Vault

Full vault API documentation