Introduction
MCP Tools
REST API
Typescript REST SDK
PythonSDK Client
Add Semantic Category
Copy
curl --request POST \
--url http://localhost:8080/api/v2/memories/semantic/category \
--header 'Content-Type: application/json' \
--data '
{
"set_id": "<string>",
"category_name": "<string>",
"prompt": "<string>",
"org_id": "universal",
"project_id": "universal",
"description": "<string>"
}
'Copy
{
"category_id": "<string>"
}Semantic Memory: Categories
Add Semantic Category
Add a semantic category to a set.
Creates a new category within a specific set. Categories define how features are extracted and organized. Each category has:
- A name for identification
- A prompt that drives LLM feature extraction
- An optional description
Returns the unique identifier of the created category.
POST
/
api
/
v2
/
memories
/
semantic
/
category
Add Semantic Category
Copy
curl --request POST \
--url http://localhost:8080/api/v2/memories/semantic/category \
--header 'Content-Type: application/json' \
--data '
{
"set_id": "<string>",
"category_name": "<string>",
"prompt": "<string>",
"org_id": "universal",
"project_id": "universal",
"description": "<string>"
}
'Copy
{
"category_id": "<string>"
}Body
application/json
Specification model for adding a semantic category.
Identifier of the semantic set.
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.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"
Optional human-readable description of the category's purpose.Response
Successful Response
Response model for adding a semantic category.
Unique identifier for the semantic category.⌘I