System API

System health, monitoring, and configuration endpoints

GET /api/openapi.json

Get OpenAPI specification

Query parameters:

Parameter	Type	Required	Description
noCache	1 \	true	No

Response: 200 OpenAPI specification

Example:

curl -X GET "https://api.memnexus.ai/api/openapi.json" \
  -H "Authorization: Bearer cmk_live_xxx.yyy"

---

GET /api/system/context/status

Get context status

Response: 200 Context status retrieved successfully

Field	Type	Required	Description
data	object	No	Database statistics and context information

Example:

curl -X GET "https://api.memnexus.ai/api/system/context/status" \
  -H "Authorization: Bearer cmk_live_xxx.yyy"

---

GET /api/system/feature-flags

Get feature flags

Response: 200 Feature flags retrieved successfully

Field	Type	Required	Description
data	object	No	Map of feature flag names to their values

Example:

curl -X GET "https://api.memnexus.ai/api/system/feature-flags" \
  -H "Authorization: Bearer cmk_live_xxx.yyy"

---

POST /api/system/feature-flags/evaluate

Evaluate feature flag

Request body:

Field	Type	Required	Description
flagName	string	Yes
context	object	No

Response: 200 Feature flag evaluation result

Field	Type	Required	Description
data	object	No

Example:

curl -X POST "https://api.memnexus.ai/api/system/feature-flags/evaluate" \
  -H "Authorization: Bearer cmk_live_xxx.yyy" \
  -H "Content-Type: application/json" \
  -d '{}'

---

GET /api/system/health

Get system health status

Response: 200 System is healthy

Field	Type	Required	Description
data	object	No

Example:

curl -X GET "https://api.memnexus.ai/api/system/health" \
  -H "Authorization: Bearer cmk_live_xxx.yyy"

---

POST /api/system/memory/prune

Prune low-quality memories

Request body:

Field	Type	Required	Description
targetReduction	number	No	Number of memories to prune
minQualityThreshold	number	No	Prune memories below this score (default 0.4)
preserveRecent	boolean	No	Don't prune recent memories (default true)
recentDaysToPreserve	number	No	Days to consider "recent" (default 7)
dryRun	boolean	No	Return what would be pruned without deleting (default false)

Response: 200 OK

Field	Type	Required	Description
data	object	No

Example:

curl -X POST "https://api.memnexus.ai/api/system/memory/prune" \
  -H "Authorization: Bearer cmk_live_xxx.yyy" \
  -H "Content-Type: application/json" \
  -d '{}'

---

GET /api/system/memory/quality

Analyze memory quality distribution

Query parameters:

Parameter	Type	Required	Description
includeDetails	boolean	No	Include detailed pruning candidate information
minQualityThreshold	number	No	Minimum quality threshold for pruning candidates (default 0.4)

Response: 200 OK

Field	Type	Required	Description
data	object	No

Example:

curl -X GET "https://api.memnexus.ai/api/system/memory/quality" \
  -H "Authorization: Bearer cmk_live_xxx.yyy"

---