Skip to main content
POST
/
api
/
v1
/
vault
/
inbox
curl -X POST https://alfred.black/api/v1/vault/inbox \
  -H "Authorization: Bearer alf_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "meeting-notes-2026-02-26.md",
    "content": "# Standup Notes\n\n- Alice: Working on ML pipeline refactor\n- Bob: Reviewing PR #234\n- Carol: Debugging production issue"
  }'

{
  "message": "Uploaded meeting-notes-2026-02-26.md to inbox",
  "filename": "meeting-notes-2026-02-26.md"
}

​
Overview

Uploads a single file to your inbox. The Curator agent will automatically process it into structured vault records.

​
Body Parameters

​
filename
string
required
Name of the file (e.g., meeting-notes-2026-02-26.md).
​
content
string
required
File contents as a string.

​
Response

​
message
string
Confirmation message.
​
filename
string
The filename that was written to the inbox.

​
Request Example

curl -X POST https://alfred.black/api/v1/vault/inbox \
  -H "Authorization: Bearer alf_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "meeting-notes-2026-02-26.md",
    "content": "# Standup Notes\n\n- Alice: Working on ML pipeline refactor\n- Bob: Reviewing PR #234\n- Carol: Debugging production issue"
  }'

​
Response Example

{
  "message": "Uploaded meeting-notes-2026-02-26.md to inbox",
  "filename": "meeting-notes-2026-02-26.md"
}