Skip to main content
POST
/
api
/
v1
/
vault
/
records
curl -X POST https://alfred.black/api/v1/vault/records \
  -H "Authorization: Bearer alf_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "person",
    "name": "Alice Chen",
    "fields": {
      "role": "ML Engineer",
      "org": "[[org/Acme Corp]]",
      "status": "active"
    },
    "body": "## Background\n\nAlice joined Acme in December 2025."
  }'

{
  "raw": "Created person/Alice Chen.md"
}

​
Overview

Creates a new record in your vault with the specified type, name, metadata fields, and content body.

​
Body Parameters

​
type
string
required
Record type (e.g., person, project, task, assumption). Must be one of the 19 known types.
​
name
string
required
Display name for the record. This becomes the filename (e.g., Alice Chen creates person/Alice Chen.md).
​
fields
object
Key-value pairs for record metadata. For example: {"status": "active", "org": "[[org/Acme Corp]]"}.
​
body
string
Content body for the record (everything after the metadata).

​
Response

Returns status 201 Created.
​
raw
string
Confirmation message. If the output is structured JSON, it is returned directly instead.

​
Request Example

curl -X POST https://alfred.black/api/v1/vault/records \
  -H "Authorization: Bearer alf_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "person",
    "name": "Alice Chen",
    "fields": {
      "role": "ML Engineer",
      "org": "[[org/Acme Corp]]",
      "status": "active"
    },
    "body": "## Background\n\nAlice joined Acme in December 2025."
  }'

​
Response Example

{
  "raw": "Created person/Alice Chen.md"
}