Skip to main content
POST
/
api
/
v2
/
memories
/
semantic
/
category
/
template
Add Semantic Category Template
curl --request POST \
  --url http://localhost:8080/api/v2/memories/semantic/category/template \
  --header 'Content-Type: application/json' \
  --data '
{
  "set_type_id": "<string>",
  "category_name": "<string>",
  "prompt": "<string>",
  "org_id": "universal",
  "project_id": "universal",
  "description": "<string>"
}
'
{
  "category_id": "<string>"
}

Body

application/json

Specification model for adding a semantic category template.

set_type_id
string
required
Unique identifier for the semantic set type.
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.