Skip to main content
POST
/
api
/
v2
/
memories
/
semantic
/
category
/
tag
Add Semantic Tag
curl --request POST \
  --url http://localhost:8080/api/v2/memories/semantic/category/tag \
  --header 'Content-Type: application/json' \
  --data '
{
  "category_id": "<string>",
  "tag_name": "<string>",
  "tag_description": "<string>",
  "org_id": "universal",
  "project_id": "universal"
}
'
{
  "tag_id": "<string>"
}

Body

application/json

Specification model for adding a tag to a category.

category_id
string
required
Unique identifier for the semantic category.
tag_name
string
required
Human-readable name for the tag. Tags represent specific types of
features within a category.
tag_description
string
required
Human-readable description of what this tag represents and when
features should be tagged with it.
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

Successful Response

Response model for adding a tag.

tag_id
string
required
Unique identifier for the semantic tag.