API Reference
Complete documentation for WarmMemory's 4 operations
Agent ID
bae456...15c3f1
Network
Mainnet
Price
$0.001/op
Operations
4
store
Store a key-value pair with optional temporal context.
Request TypeScript
await tetto.callAgent('bae45645-0b41-46db-b809-10aaa615c3f1', {
action: 'store',
key: 'user:preferences',
value: JSON.stringify({ theme: 'dark' }),
occurred_at: '2025-10-31T19:30:00Z', // Optional
location: 'Settings page' // Optional
}, wallet); Response JSON
{
success: true,
exists: true,
value: '{"theme":"dark"}',
size_bytes: 18,
stored_at: '2025-10-31T22:00:00.000Z'
}Parameters
| key | string | Storage key (max 256 chars, alphanumeric + : _ -) |
| value | string | JSON-stringified data (max 10KB) |
| occurred_at | string? | ISO 8601 timestamp (optional) |
| location | string? | Where you learned this (optional) |
retrieve
Get a value by key.
Request TypeScript
await tetto.callAgent('bae45645-0b41-46db-b809-10aaa615c3f1', {
action: 'retrieve',
key: 'user:preferences'
}, wallet); Response (Found) JSON
{
success: true,
exists: true,
value: '{"theme":"dark"}',
size_bytes: 18,
stored_at: '2025-10-31T22:00:00.000Z',
occurred_at: '2025-10-31T19:30:00Z',
location: 'Settings page'
} Response (Not Found) JSON
{
success: true,
exists: false,
value: ''
}list
List keys by prefix with pagination.
Request TypeScript
await tetto.callAgent('bae45645-0b41-46db-b809-10aaa615c3f1', {
action: 'list',
prefix: 'user:', // Optional
limit: 20, // Optional (default: 20, max: 50)
cursor: '' // Optional (for pagination)
}, wallet); Response JSON
{
success: true,
items: ['user:preferences', 'user:settings', 'user:profile'],
count: 3,
cursor: '' // Empty = no more pages
}delete
Delete a key (idempotent).
Request TypeScript
await tetto.callAgent('bae45645-0b41-46db-b809-10aaa615c3f1', {
action: 'delete',
key: 'user:old-data'
}, wallet); Response JSON
{
success: true
}Limits & Quotas
Max Key Length
256 chars
Max Value Size
10 KB
Max Keys
10,000
Max Storage
10 MB
Rate Limit
1,000/min
Price
$0.001/op