Get Semantic Category
curl --request POST \
--url http://localhost:8080/api/v2/memories/semantic/category/get \
--header 'Content-Type: application/json' \
--data '
{
"category_id": "<string>",
"org_id": "universal",
"project_id": "universal"
}
'import requests
url = "http://localhost:8080/api/v2/memories/semantic/category/get"
payload = {
"category_id": "<string>",
"org_id": "universal",
"project_id": "universal"
}
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({category_id: '<string>', org_id: 'universal', project_id: 'universal'})
};
fetch('http://localhost:8080/api/v2/memories/semantic/category/get', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "8080",
CURLOPT_URL => "http://localhost:8080/api/v2/memories/semantic/category/get",
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([
'category_id' => '<string>',
'org_id' => 'universal',
'project_id' => 'universal'
]),
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;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "http://localhost:8080/api/v2/memories/semantic/category/get"
payload := strings.NewReader("{\n \"category_id\": \"<string>\",\n \"org_id\": \"universal\",\n \"project_id\": \"universal\"\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))
}HttpResponse<String> response = Unirest.post("http://localhost:8080/api/v2/memories/semantic/category/get")
.header("Content-Type", "application/json")
.body("{\n \"category_id\": \"<string>\",\n \"org_id\": \"universal\",\n \"project_id\": \"universal\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:8080/api/v2/memories/semantic/category/get")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"category_id\": \"<string>\",\n \"org_id\": \"universal\",\n \"project_id\": \"universal\"\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"name": "<string>",
"prompt": "<string>",
"description": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Semantic Memory: Categories
Get Semantic Category
Get a semantic category by ID.
Retrieves a specific category using its unique identifier. Returns the category name, prompt, and description.
Returns 404 if the category does not exist.
POST
/
api
/
v2
/
memories
/
semantic
/
category
/
get
Get Semantic Category
curl --request POST \
--url http://localhost:8080/api/v2/memories/semantic/category/get \
--header 'Content-Type: application/json' \
--data '
{
"category_id": "<string>",
"org_id": "universal",
"project_id": "universal"
}
'import requests
url = "http://localhost:8080/api/v2/memories/semantic/category/get"
payload = {
"category_id": "<string>",
"org_id": "universal",
"project_id": "universal"
}
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({category_id: '<string>', org_id: 'universal', project_id: 'universal'})
};
fetch('http://localhost:8080/api/v2/memories/semantic/category/get', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "8080",
CURLOPT_URL => "http://localhost:8080/api/v2/memories/semantic/category/get",
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([
'category_id' => '<string>',
'org_id' => 'universal',
'project_id' => 'universal'
]),
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;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "http://localhost:8080/api/v2/memories/semantic/category/get"
payload := strings.NewReader("{\n \"category_id\": \"<string>\",\n \"org_id\": \"universal\",\n \"project_id\": \"universal\"\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))
}HttpResponse<String> response = Unirest.post("http://localhost:8080/api/v2/memories/semantic/category/get")
.header("Content-Type", "application/json")
.body("{\n \"category_id\": \"<string>\",\n \"org_id\": \"universal\",\n \"project_id\": \"universal\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:8080/api/v2/memories/semantic/category/get")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"category_id\": \"<string>\",\n \"org_id\": \"universal\",\n \"project_id\": \"universal\"\n}"
response = http.request(request)
puts response.read_body{
"id": "<string>",
"name": "<string>",
"prompt": "<string>",
"description": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Body
application/json
Specification model for getting a semantic category.
Unique identifier for the semantic category.
The unique identifier of the organization.
- Must not contain slashes (`/`).
- Must contain only letters, numbers, underscores, hyphens, colon, and Unicode
characters (e.g., Chinese/Japanese/Korean). No slashes or other symbols
are allowed.
This value determines the namespace the project belongs to.
Examples:
"MemVerge"
"AI_Labs"
The identifier of the project.
- Must be unique within the organization.
- Must not contain slashes (`/`).
- Must contain only letters, numbers, underscores, hyphens, colon, and Unicode
characters (e.g., Chinese/Japanese/Korean). No slashes or other symbols
are allowed.
This ID is used in API paths and resource locations.
Examples:
"memmachine"
"research123"
"qa_pipeline"
Response
SemanticCategoryEntry · object | null
Successful Response
A semantic category entry.
Unique identifier for the semantic category.
Human-readable name for the category. Categories group related features
together for extraction and organization.
The prompt template used for extracting features in this category.
This drives the LLM's feature extraction behavior.
Optional human-readable description of the category's purpose.
⌘I

