Skip to main content
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"
}
'
{
  "id": "<string>",
  "name": "<string>",
  "prompt": "<string>",
  "description": "<string>"
}

Body

application/json

Specification model for getting a semantic category.

category_id
string
required
Unique identifier for the semantic category.
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"

Response

SemanticCategoryEntry · object | null

Successful Response

A semantic category entry.

id
string
required
Unique identifier for the semantic 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.
description
string | null
Optional human-readable description of the category's purpose.