MemoryApi

valkyrai-api

All URIs are relative to http://localhost:8080/v1

Method	HTTP request	Description
compactMemory	POST MemoryApi	Compact memory (reduce context size)

compactMemory

MemoryActionResponse

compactMemory(memoryActionRequest)

Compact memory (reduce context size)

Runs the memory compaction ExecModule to reduce context size. Costs credits.

Example

Import classes:
import com.valkyrlabs.ApiException;
import com.valkyrlabs.api.MemoryApi;


MemoryApi apiInstance = new MemoryApi();
MemoryActionRequest memoryActionRequest = new MemoryActionRequest(); // MemoryActionRequest | 

try {
    MemoryActionResponse result = apiInstance.compactMemory(memoryActionRequest);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling MemoryApi#compactMemory");
    e.printStackTrace();
}

Parameters

Name	Type	Description	Notes
memoryActionRequest	MemoryActionRequest		[optional]

Return type

MemoryActionResponse

Authorization

No authorization required

HTTP request headers

• Content-Type: application/json
• Accept: application/json

expandMemory

MemoryActionResponse

expandMemory(memoryActionRequest)

Expand context window

Upgrades context capacity for the current session. Costs credits.

Example

Import classes:
import com.valkyrlabs.ApiException;
import com.valkyrlabs.api.MemoryApi;


MemoryApi apiInstance = new MemoryApi();
MemoryActionRequest memoryActionRequest = new MemoryActionRequest(); // MemoryActionRequest | 

try {
    MemoryActionResponse result = apiInstance.expandMemory(memoryActionRequest);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling MemoryApi#expandMemory");
    e.printStackTrace();
}

Parameters

Name	Type	Description	Notes
memoryActionRequest	MemoryActionRequest		[optional]

Return type

MemoryActionResponse

Authorization

No authorization required

HTTP request headers

• Content-Type: application/json
• Accept: application/json

getMemoryRuns

MemoryRunRecord

getMemoryRuns(limit)

Get recent workflow run records with memory cost data

Returns the last N workflow runs for the current principal, including memory cost and quality signals, for the run timeline panel.

Example

Import classes:
import com.valkyrlabs.ApiException;
import com.valkyrlabs.api.MemoryApi;


MemoryApi apiInstance = new MemoryApi();
Integer limit = 20; // Integer | 

try {
    MemoryRunRecord result = apiInstance.getMemoryRuns(limit);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling MemoryApi#getMemoryRuns");
    e.printStackTrace();
}

Parameters

Name	Type	Description	Notes
limit	Integer		[optional] [default to 20]

Return type

MemoryRunRecord

Authorization

No authorization required

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

getMemoryStats

MemoryStats

getMemoryStats()

Get memory stats for current principal

Returns real-time context fill percentage, hit rate, waste ratio, and cost burn data for the GrayMatter Memory Dashboard.

Example

Import classes:
import com.valkyrlabs.ApiException;
import com.valkyrlabs.api.MemoryApi;


MemoryApi apiInstance = new MemoryApi();

try {
    MemoryStats result = apiInstance.getMemoryStats();
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling MemoryApi#getMemoryStats");
    e.printStackTrace();
}

Parameters

This endpoint does not need any parameter.

Return type

MemoryStats

Authorization

No authorization required

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

pruneMemory

MemoryActionResponse

pruneMemory(memoryActionRequest)

Prune memory (remove noise)

Removes low-relevance or expired MemoryEntry records for the current principal. Costs credits.

Example

Import classes:
import com.valkyrlabs.ApiException;
import com.valkyrlabs.api.MemoryApi;


MemoryApi apiInstance = new MemoryApi();
MemoryActionRequest memoryActionRequest = new MemoryActionRequest(); // MemoryActionRequest | 

try {
    MemoryActionResponse result = apiInstance.pruneMemory(memoryActionRequest);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling MemoryApi#pruneMemory");
    e.printStackTrace();
}

Parameters

Name	Type	Description	Notes
memoryActionRequest	MemoryActionRequest		[optional]

Return type

MemoryActionResponse

Authorization

No authorization required

HTTP request headers

• Content-Type: application/json
• Accept: application/json

reindexMemory

MemoryActionResponse

reindexMemory(memoryActionRequest)

Reindex memory (improve hit rate)

Rebuilds memory index to improve retrieval hit rate. Costs credits.

Example

Import classes:
import com.valkyrlabs.ApiException;
import com.valkyrlabs.api.MemoryApi;


MemoryApi apiInstance = new MemoryApi();
MemoryActionRequest memoryActionRequest = new MemoryActionRequest(); // MemoryActionRequest | 

try {
    MemoryActionResponse result = apiInstance.reindexMemory(memoryActionRequest);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling MemoryApi#reindexMemory");
    e.printStackTrace();
}

Parameters

Name	Type	Description	Notes
memoryActionRequest	MemoryActionRequest		[optional]

Return type

MemoryActionResponse

Authorization

No authorization required

HTTP request headers

• Content-Type: application/json
• Accept: application/json

Generated Version Details

~	value
GENERATOR VERSION	com.valkyrlabs:ValkyrAI API 1.0.3-SNAPSHOT
API ARTIFACT	com.valkyrlabs.valkyrai-api.jar
GENERATOR VERSION	org.openapitools.openapi-generator:7.5.0
GENERATOR CLASS	org.openapitools.codegen.languages.SpringCodegen
GENERATED DATE	2026-04-20T19:24:54.195235-07:00[America/Los_Angeles]