{"uid":"cap_2OLge-S-aCL6Tkd_MbZ8x","slug":"agentbit-app-key-value-memory-9e36191b","name":"agentbit.app Key-Value Memory","description":"Private key/value memory for an agent: remember values across calls (set/get/delete/list/exists), scoped to the paying wallet.","url":"https://agentbit.app/v1/memory?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"key":{"type":"string","description":"The key (required for set/get/delete/exists)."},"limit":{"type":"integer","description":"For list: max keys to return (default 100, max 500)."},"value":{"description":"Any JSON value to store (required for set)."},"namespace":{"type":"string","description":"Optional group for keys (default \"default\")."},"operation":{"enum":["set","get","delete","exists","list"],"type":"string","description":"What to do."},"ttl_seconds":{"type":"integer","description":"Optional expiry in seconds (default 30 days, max 90; 0 = no expiry)."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OkoyoEHa6bs9aYwvWLwUA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Persistent private key-value store for agents: set, get, delete, check existence, or list stored values scoped to the paying wallet.","exampleAgentPrompt":"Store the value 'premium' under the key 'user_tier' in the 'subscriptions' namespace, and set it to expire in 3600 seconds.","exampleUseCases":[{"title":"Persist user preferences across sessions","prompt":"Remember that the user prefers Celsius temperature units — save that under the key 'temp_unit' with the value 'celsius' in the 'user_prefs' namespace so you can recall it next time."},{"title":"Cache workflow intermediate results","prompt":"Store this JSON summary under the key 'last_report_summary' in the 'reports' namespace, and make it expire in 86400 seconds so it refreshes daily."},{"title":"Check onboarding completion flag","prompt":"Check whether the key 'onboarding_complete' exists in my 'state' namespace — I need to know if the user has already finished setup before proceeding."}],"resultDescription":"Returns a JSON object containing the operation result: for 'get', the stored value; for 'exists', a boolean; for 'list', an array of keys up to the specified limit; for 'set' and 'delete', a confirmation of success. Data is scoped to the paying wallet.","failureModes":["Key not found on 'get' or 'delete' returns null or 404-style result","Missing required 'key' field for set/get/delete/exists operations returns validation error","Missing required 'value' field for 'set' operation returns validation error","TTL exceeding 90 days is clamped or rejected","Invalid operation enum value returns an error","Payment failure or insufficient balance blocks the call"],"whenToPreferThis":"Use this endpoint when an AI agent needs lightweight persistent state or memory across calls — session flags, user preferences, cached results, or workflow checkpoints — scoped privately to the paying wallet. Prefer it over in-context memory when data must survive across sessions, and over full databases when simplicity and per-call pricing are priorities.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T18:39:47.688Z","isFirstParty":false,"canonicalSlug":"agentbit-app-key-value-memory-9e36191b"}