curl --request GET \
--url https://ds.cominty.com/memory/file \
--header 'x-cominty-token: <api-key>'import requests
url = "https://ds.cominty.com/memory/file"
headers = {"x-cominty-token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-cominty-token': '<api-key>'}};
fetch('https://ds.cominty.com/memory/file', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://ds.cominty.com/memory/file",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-cominty-token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://ds.cominty.com/memory/file"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-cominty-token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://ds.cominty.com/memory/file")
.header("x-cominty-token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://ds.cominty.com/memory/file")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-cominty-token"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"path": "<string>",
"purpose": "<string>",
"namespace": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"content": "<string>",
"version": "2023-11-07T05:31:56Z"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Get a memory file
Fetch one file, including its content. With an API token, namespace is required. A missing file returns 404.
curl --request GET \
--url https://ds.cominty.com/memory/file \
--header 'x-cominty-token: <api-key>'import requests
url = "https://ds.cominty.com/memory/file"
headers = {"x-cominty-token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-cominty-token': '<api-key>'}};
fetch('https://ds.cominty.com/memory/file', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://ds.cominty.com/memory/file",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-cominty-token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://ds.cominty.com/memory/file"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-cominty-token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://ds.cominty.com/memory/file")
.header("x-cominty-token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://ds.cominty.com/memory/file")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-cominty-token"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"path": "<string>",
"purpose": "<string>",
"namespace": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"content": "<string>",
"version": "2023-11-07T05:31:56Z"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Authorizations
A Cominty Platform API secret. A key created now starts with sk-cmt-. Send it as is, or as Bearer sk-cmt-..., with at most one Bearer prefix. A key created before the prefix existed has no sk-cmt- and still works.
Query Parameters
Relative path with at most one folder segment, for example notes/todo.md. a/b/todo.md returns 422.
Namespace the file belongs to. Required for an API token. Omitting it returns 400 Missing namespace. At most 128 characters.
128Optional. Does not select the memory namespace.
Response
Successful Response
Path as stored.
Why the file exists.
Namespace the file belongs to.
When the file was created.
When the file was last updated.
File body. May be empty.
Opaque version identifier; echo back as version when updating.