Route an Input

Manually route an input to a vault destination. Triggers the Curator for structured processing (creating notes, extracting entities, interlinking). Falls back to a raw file move if the Curator is unavailable. Creates an enriched observation from the routing decision.

POST /api/v1/learning/route

Route an Input

cURL

curl --request POST \
  --url https://alfred.black/api/v1/learning/route \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "input_id": "<string>",
  "destination": "<string>"
}
'

200

{
  "message": "Routed input/email-abc.md to project/client-onboarding",
  "processed": true,
  "note_path": "note/2026/03/client-onboarding-update.md",
  "entities_created": [
    "person/Jane Doe.md"
  ],
  "entities_linked": [
    "project/client-onboarding.md"
  ],
  "observation": "observation/route-email-abc-2026-03-22T08-30-00-000Z.md"
}

Authorizations

Authorization · string · header · required

API key in the format alf_<32 hex chars>. Pass in the Authorization header as Bearer alf_....

Body

application/json

input_id · string · required

Vault-relative path to the input to route

destination · string · required

Vault destination path (e.g., project/client-onboarding)

Response

200

application/json

Input routed

message · string

processed · boolean

Whether the Curator successfully processed the input

note_path · string | null

Path to the note created by the Curator

entities_created · string[]

Entity records created during processing

entities_linked · string[]

Entity records linked during processing

observation · string

Path to the observation record