Get Semantic Set Id
curl --request POST \
--url http://localhost:8080/api/v2/memories/semantic/set_id/get \
--header 'Content-Type: application/json' \
--data '
{
"metadata_tags": [
"<string>"
],
"org_id": "MemVerge",
"project_id": "memmachine",
"is_org_level": false,
"set_metadata": {}
}
'import requests
url = "http://localhost:8080/api/v2/memories/semantic/set_id/get"
payload = {
"metadata_tags": ["<string>"],
"org_id": "MemVerge",
"project_id": "memmachine",
"is_org_level": False,
"set_metadata": {}
}
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({
metadata_tags: ['<string>'],
org_id: 'MemVerge',
project_id: 'memmachine',
is_org_level: false,
set_metadata: {}
})
};
fetch('http://localhost:8080/api/v2/memories/semantic/set_id/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/set_id/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([
'metadata_tags' => [
'<string>'
],
'org_id' => 'MemVerge',
'project_id' => 'memmachine',
'is_org_level' => false,
'set_metadata' => [
]
]),
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/set_id/get"
payload := strings.NewReader("{\n \"metadata_tags\": [\n \"<string>\"\n ],\n \"org_id\": \"MemVerge\",\n \"project_id\": \"memmachine\",\n \"is_org_level\": false,\n \"set_metadata\": {}\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/set_id/get")
.header("Content-Type", "application/json")
.body("{\n \"metadata_tags\": [\n \"<string>\"\n ],\n \"org_id\": \"MemVerge\",\n \"project_id\": \"memmachine\",\n \"is_org_level\": false,\n \"set_metadata\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:8080/api/v2/memories/semantic/set_id/get")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"metadata_tags\": [\n \"<string>\"\n ],\n \"org_id\": \"MemVerge\",\n \"project_id\": \"memmachine\",\n \"is_org_level\": false,\n \"set_metadata\": {}\n}"
response = http.request(request)
puts response.read_body{
"set_id": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Semantic Memory: Sets
Get Semantic Set Id
Get or create a semantic set ID.
Returns the set ID for the given set type configuration and optional metadata. If the set does not exist, it is created.
The set ID is deterministically generated based on:
- Organization and project scope
- Set type (org-level or project-level)
- Metadata tags and values
POST
/
api
/
v2
/
memories
/
semantic
/
set_id
/
get
Get Semantic Set Id
curl --request POST \
--url http://localhost:8080/api/v2/memories/semantic/set_id/get \
--header 'Content-Type: application/json' \
--data '
{
"metadata_tags": [
"<string>"
],
"org_id": "MemVerge",
"project_id": "memmachine",
"is_org_level": false,
"set_metadata": {}
}
'import requests
url = "http://localhost:8080/api/v2/memories/semantic/set_id/get"
payload = {
"metadata_tags": ["<string>"],
"org_id": "MemVerge",
"project_id": "memmachine",
"is_org_level": False,
"set_metadata": {}
}
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({
metadata_tags: ['<string>'],
org_id: 'MemVerge',
project_id: 'memmachine',
is_org_level: false,
set_metadata: {}
})
};
fetch('http://localhost:8080/api/v2/memories/semantic/set_id/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/set_id/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([
'metadata_tags' => [
'<string>'
],
'org_id' => 'MemVerge',
'project_id' => 'memmachine',
'is_org_level' => false,
'set_metadata' => [
]
]),
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/set_id/get"
payload := strings.NewReader("{\n \"metadata_tags\": [\n \"<string>\"\n ],\n \"org_id\": \"MemVerge\",\n \"project_id\": \"memmachine\",\n \"is_org_level\": false,\n \"set_metadata\": {}\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/set_id/get")
.header("Content-Type", "application/json")
.body("{\n \"metadata_tags\": [\n \"<string>\"\n ],\n \"org_id\": \"MemVerge\",\n \"project_id\": \"memmachine\",\n \"is_org_level\": false,\n \"set_metadata\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:8080/api/v2/memories/semantic/set_id/get")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"metadata_tags\": [\n \"<string>\"\n ],\n \"org_id\": \"MemVerge\",\n \"project_id\": \"memmachine\",\n \"is_org_level\": false,\n \"set_metadata\": {}\n}"
response = http.request(request)
puts response.read_body{
"set_id": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Body
application/json
Specification model for getting a semantic set ID.
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"

