{"uid":"cap_GVfyKA3BaWgDIwowlVpWG","slug":"manylives-ai-memory-get-2a721614","name":"ManyLives AI - Memory Get","description":"Read back values the paying wallet saved with /paid/memory/set: one key, or list your keys by prefix (keys, sizes and expiry, newest first). Another wallet can never see them. No free trial.","url":"https://api.manylives.me/paid/memory/get?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","const":"GET"},"queryParams":{"type":"object","required":[],"properties":{"key":{"type":"string","description":"the key to read (or use prefix to list)"},"delete":{"type":"string","description":"optional 1 to delete the key after reading"},"prefix":{"type":"string","description":"optional: list keys starting with this"}}}}},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","properties":{"key":{"type":"string"},"found":{"type":"boolean"},"value":{"type":"object","properties":{"todo":{"type":"array","items":{"type":"string"}}}},"expires_at":{"type":"string"},"updated_at":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"key":"project/notes","found":true,"value":{"todo":["compare prices"]},"expires_at":"2026-11-08T12:00:00Z","updated_at":"2026-10-09T12:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yIlxxD3WJjO7QH1EqdblB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Reads a stored key-value memory entry (or lists keys by prefix) from a persistent agent memory store, with optional delete-after-read","exampleAgentPrompt":"Read the memory key 'project/notes' from my ManyLives agent memory and show me what's stored there — and delete it after reading.","exampleUseCases":[{"title":"Retrieve agent todo list mid-workflow","prompt":"Fetch whatever is stored under the key 'agent/tasks/pending' in my ManyLives memory so I can see what the agent left to do."},{"title":"List all keys under a namespace","prompt":"Show me all the memory keys that start with the prefix 'trading_bot/' so I can see what my trading agent has saved."},{"title":"Read and clear a one-time checkpoint","prompt":"Get the value stored at 'workflow/checkpoint/step3' and delete it after reading so the next run starts fresh."}],"resultDescription":"Returns a JSON object with the key name, a 'found' boolean, the stored value (arbitrary JSON object), the expiry timestamp, and the last-updated timestamp. If no key matches, 'found' is false and no value is returned. When using prefix, returns a list of matching keys.","failureModes":["Key not found: 'found' returns false with no value","Missing required 'key' or 'prefix' parameter: request fails with validation error","Expired key: may return not found if TTL has elapsed","Payment failure: x402 payment not processed, call rejected","Invalid delete flag value: unexpected behavior if not '1'"],"whenToPreferThis":"Use this endpoint when an AI agent needs to persist and retrieve state, notes, or intermediate results across calls without managing its own database. It is ideal for multi-step agentic workflows on the ManyLives platform where agents need to read back previously stored context, checkpoints, or task lists. The delete-after-read feature makes it suitable for one-time-use tokens or consumed tasks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:42:08.957Z","isFirstParty":false,"canonicalSlug":"manylives-ai-memory-get-2a721614"}