Skip to main content
GET
/
api
/
v1
/
vault
/
inbox
curl -X GET https://alfred.black/api/v1/vault/inbox \
  -H "Authorization: Bearer alf_your_key_here"

{
  "files": [
    "meeting-notes-2026-02-26.md",
    "project-idea.md",
    "contact-info.txt"
  ]
}

​
Overview

Returns a list of all files currently in your inbox waiting to be processed by the Curator agent. Once the Curator processes a file, it is removed from this list.

​
Response

​
files
array
Array of filenames in the inbox.

​
Request Example

curl -X GET https://alfred.black/api/v1/vault/inbox \
  -H "Authorization: Bearer alf_your_key_here"

​
Response Example

{
  "files": [
    "meeting-notes-2026-02-26.md",
    "project-idea.md",
    "contact-info.txt"
  ]
}