Skip to main content
POST
/
api
/
v2
/
memories
/
semantic
/
category
Add Semantic Category
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>"
}
'
{
  "category_id": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.memmachine.ai/llms.txt

Use this file to discover all available pages before exploring further.

Body

application/json

Specification model for adding a semantic category.

​
set_id
string
required

Identifier of the semantic set.

​
category_name
string
required
Human-readable name for the category. Categories group related features
together for extraction and organization.
​
prompt
string
required
The prompt template used for extracting features in this category.
This drives the LLM's feature extraction behavior.
​
org_id
string
default:universal
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"

​
project_id
string
default:universal
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"

​
description
string | null
Optional human-readable description of the category's purpose.

Response

Successful Response

Response model for adding a semantic category.

​
category_id
string
required
Unique identifier for the semantic category.