Skip to main content
POST
/
api
/
v1
/
workers
/
process
curl -X POST https://alfred.black/api/v1/workers/process \
  -H "Authorization: Bearer alf_your_key_here" \
  -H "Content-Type: application/json"

{
  "processed": 10,
  "skipped": 2
}
Triggers the Curator to process inbox files as a one-time batch operation. Each inbox item is analyzed and converted into structured vault records. This is separate from the continuous background processing that the Curator agent performs automatically.
​
limit
number
Maximum number of inbox files to process. If omitted, processes all files.
​
dry_run
boolean
default:false
If true, returns what would be processed without actually running the Curator.
​
jobs
number
Number of parallel processing jobs.
curl -X POST https://alfred.black/api/v1/workers/process \
  -H "Authorization: Bearer alf_your_key_here" \
  -H "Content-Type: application/json"

{
  "processed": 10,
  "skipped": 2
}
If the response contains structured JSON, it is returned directly. Otherwise, the output is returned in a raw field.
​
raw
string
Human-readable output when structured JSON is not available.