Ingest a file as context
curl --request POST \
--url http://127.0.0.1:4319/context/add \
--header 'Content-Type: application/json' \
--data '
{
"path": "C:\\Users\\me\\notes\\setup.md"
}
'import requests
url = "http://127.0.0.1:4319/context/add"
payload = { "path": "C:\Users\me\notes\setup.md" }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({path: 'C:\Users\me\notes\setup.md'})
};
fetch('http://127.0.0.1:4319/context/add', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "http://127.0.0.1:4319/context/add"
payload := strings.NewReader("{\n \"path\": \"C:\\\\Users\\\\me\\\\notes\\\\setup.md\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "4319",
CURLOPT_URL => "http://127.0.0.1:4319/context/add",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'path' => 'C:\\Users\\me\\notes\\setup.md'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}require 'uri'
require 'net/http'
url = URI("http://127.0.0.1:4319/context/add")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"path\": \"C:\\\\Users\\\\me\\\\notes\\\\setup.md\"\n}"
response = http.request(request)
puts response.read_bodyHttpResponse<String> response = Unirest.post("http://127.0.0.1:4319/context/add")
.header("Content-Type", "application/json")
.body("{\n \"path\": \"C:\\\\Users\\\\me\\\\notes\\\\setup.md\"\n}")
.asString();using RestSharp;
var options = new RestClientOptions("http://127.0.0.1:4319/context/add");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddJsonBody("{\n \"path\": \"C:\\\\Users\\\\me\\\\notes\\\\setup.md\"\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
{
"documentId": "<string>",
"title": "Deploy Guide",
"chunks": 12
}{
"error": "invalid request body",
"issues": [
{
"path": "query",
"message": "query must be a non-empty string"
}
]
}{
"error": "the store is locked by a connected Postgres wire client (Drizzle Studio, psql, a DB panel). PGLite is single-connection; disconnect that client and retry."
}Context
Ingest a file as context
Extract, chunk, embed, and store a .md/.txt/.pdf file from the daemon’s machine.
A document mirrors its file: re-adding an unchanged file is a no-op
(unchanged), a changed file replaces its chunks (updated). Markdown chunks carry
their heading breadcrumb; PDF chunks keep their page number. Chunks surface in normal
/memory/query results with a source.
POST
/
context
/
add
Ingest a file as context
curl --request POST \
--url http://127.0.0.1:4319/context/add \
--header 'Content-Type: application/json' \
--data '
{
"path": "C:\\Users\\me\\notes\\setup.md"
}
'import requests
url = "http://127.0.0.1:4319/context/add"
payload = { "path": "C:\Users\me\notes\setup.md" }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({path: 'C:\Users\me\notes\setup.md'})
};
fetch('http://127.0.0.1:4319/context/add', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "http://127.0.0.1:4319/context/add"
payload := strings.NewReader("{\n \"path\": \"C:\\\\Users\\\\me\\\\notes\\\\setup.md\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "4319",
CURLOPT_URL => "http://127.0.0.1:4319/context/add",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'path' => 'C:\\Users\\me\\notes\\setup.md'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}require 'uri'
require 'net/http'
url = URI("http://127.0.0.1:4319/context/add")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"path\": \"C:\\\\Users\\\\me\\\\notes\\\\setup.md\"\n}"
response = http.request(request)
puts response.read_bodyHttpResponse<String> response = Unirest.post("http://127.0.0.1:4319/context/add")
.header("Content-Type", "application/json")
.body("{\n \"path\": \"C:\\\\Users\\\\me\\\\notes\\\\setup.md\"\n}")
.asString();using RestSharp;
var options = new RestClientOptions("http://127.0.0.1:4319/context/add");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddJsonBody("{\n \"path\": \"C:\\\\Users\\\\me\\\\notes\\\\setup.md\"\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
{
"documentId": "<string>",
"title": "Deploy Guide",
"chunks": 12
}{
"error": "invalid request body",
"issues": [
{
"path": "query",
"message": "query must be a non-empty string"
}
]
}{
"error": "the store is locked by a connected Postgres wire client (Drizzle Studio, psql, a DB panel). PGLite is single-connection; disconnect that client and retry."
}Body
application/json
Absolute path to a .md, .txt, or .pdf file on this machine.
Example:
"C:\\Users\\me\\notes\\setup.md"
Response
What happened to the document.
converted means the path matched an earlier upload snapshot, which was absorbed into this linked document. exists means the content is already present as a linked document.
Available options:
added, updated, unchanged, converted, exists Example:
"Deploy Guide"
Example:
12
⌘I