{"uid":"cap_GiVhNmoefj-i_icWg57oZ","slug":"agent-data-tools-revmesh2074-workers-dev-agent-memory-list-keys-9b6a1af6","name":"Agent Memory: List Namespace Keys","description":"List up to 100 keys saved in your namespace, optionally only those starting with a prefix, with their size, save time and expiry; pass the returned cursor for the next page. Values are not included (read them with /memory/get). Values are kept until they expire (at most 30 days) or are deleted; reads anywhere may lag a write made elsewhere by up to a minute. Use to see what an agent has saved.","url":"https://agent-data-tools.revmesh2074.workers.dev/memory/list?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["namespace"],"properties":{"cursor":{"type":"string","description":"The cursor from the previous page of this list"},"prefix":{"type":"string","description":"Only keys that start with this text"},"namespace":{"type":"string","description":"Your namespace: a secret of 16 to 128 letters, digits, - or _ that you choose and reuse. Anyone who knows it can read and write it, so treat it like a password; send it in a POST body to keep it out of URLs."}}},"responseSchema":{"type":"object","properties":{"keys":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"size":{"type":"number"},"expiresAt":{"type":"string"},"updatedAt":{"type":"string"}}}},"count":{"type":"number"},"cursor":{}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USD","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_3M4kVnMcZ3dcQf6nPIdf2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agent-data-tools.revmesh2074.workers.dev","brandSlug":"agent-data-tools-revmesh2074-workers-dev-x402","brandBaseUrl":"https://agent-data-tools.revmesh2074.workers.dev","brandDocsUrl":null,"whatItDoes":"Lists up to 100 keys stored in an agent's memory namespace, with size, save time, and expiry metadata, supporting cursor-based pagination and prefix filtering.","exampleAgentPrompt":"Show me all the keys my agent has saved in namespace 'my-agent-session-xyz123abc456def7', and filter to only ones starting with 'task-'.","exampleUseCases":[{"title":"Audit saved agent state","prompt":"List all the keys stored in my agent's memory namespace 'workflow-agent-abc123xyz789def0' so I can see what it has remembered from previous sessions."},{"title":"Browse paginated memory namespace","prompt":"My agent has a lot of saved data in namespace 'pipeline-state-q1r2s3t4u5v6w7x8' — fetch the next page of keys using cursor 'eyJrZXkiOiJ0YXNrLTEifQ' so I can keep scrolling through what's stored."},{"title":"Find task-related memory keys","prompt":"In namespace 'research-bot-secret-abc123def456gh78', list only the keys that start with 'report-' so I can see which reports my agent has cached."}],"resultDescription":"Returns a JSON object containing an array of key entries (each with key name, size in bytes, updatedAt timestamp, and expiresAt timestamp), the total count of matched keys, and a cursor string for fetching the next page. Values themselves are not included — use /memory/get to retrieve them.","failureModes":["Missing or invalid namespace returns an error (namespace must be 16–128 alphanumeric/-/_ characters)","Namespace not found or empty returns keys: [] with count: 0","Invalid cursor string causes pagination to fail or restart from the beginning","Prefix filter with no matches returns empty keys array","Eventual consistency lag: a key written recently elsewhere may not appear for up to 60 seconds","Rate limiting or payment failure returns 402 if credits are exhausted"],"whenToPreferThis":"Use this endpoint when an agent needs to discover or audit what it has previously stored in a namespace, navigate large sets of saved data via pagination, or filter stored keys by a known prefix before fetching specific values. Prefer this over /memory/get when you don't yet know which exact keys exist or want a summary view (sizes, expiry) without loading values. It is the right starting point for any inspection or cleanup workflow over agent-persisted state.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-26T04:45:35.144Z","isFirstParty":false,"canonicalSlug":"agent-data-tools-revmesh2074-workers-dev-agent-memory-list-keys-9b6a1af6"}