Skip to main content
POST
/
api
/
v1
/
vault
/
inbox
/
bulk
curl -X POST https://alfred.black/api/v1/vault/inbox/bulk \
  -H "Authorization: Bearer alf_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "files": [
      {
        "filename": "meeting-notes-2026-02-26.md",
        "content": "# Standup Notes\n\n- Alice: ML pipeline work"
      },
      {
        "filename": "project-idea.md",
        "content": "# New Project Idea\n\nBuild a knowledge graph..."
      },
      {
        "filename": "contact-info.txt",
        "content": "Name: David Lee\nEmail: david@example.com"
      }
    ]
  }'

{
  "message": "Uploaded 3 files to inbox",
  "filenames": [
    "meeting-notes-2026-02-26.md",
    "project-idea.md",
    "contact-info.txt"
  ]
}

​
Overview

Uploads multiple files to your inbox in a single request. The Curator agent will process each file into structured vault records. If any file has an invalid filename or missing content, the entire request fails.

​
Body Parameters

​
files
array
required
Array of file objects to upload.
​
filename
string
required
Name of the file.
​
content
string
required
File contents as a string.

​
Response

​
message
string
Confirmation message.
​
filenames
array
Array of filenames that were written to the inbox.

​
Request Example

curl -X POST https://alfred.black/api/v1/vault/inbox/bulk \
  -H "Authorization: Bearer alf_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "files": [
      {
        "filename": "meeting-notes-2026-02-26.md",
        "content": "# Standup Notes\n\n- Alice: ML pipeline work"
      },
      {
        "filename": "project-idea.md",
        "content": "# New Project Idea\n\nBuild a knowledge graph..."
      },
      {
        "filename": "contact-info.txt",
        "content": "Name: David Lee\nEmail: david@example.com"
      }
    ]
  }'

​
Response Example

{
  "message": "Uploaded 3 files to inbox",
  "filenames": [
    "meeting-notes-2026-02-26.md",
    "project-idea.md",
    "contact-info.txt"
  ]
}