{"uid":"cap_cHWrA6ZH6SBgYbYa43_gS","slug":"kiln-memory-read-document-fec8da1d","name":"Kiln Memory – Read Document","description":"Read document","url":"https://memory.fluidrack.com/v1/ns/:ns/docs/:key","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":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":["ns","key"],"properties":{"ns":{"type":"string"},"key":{"type":"string"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jvzMIeZE96lALZogaDNU5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a stored JSON document from a durable TTL namespace by key","exampleAgentPrompt":"Can you fetch the document stored under the key 'session-context-42' in the 'agent-workspace' namespace from Kiln Memory?","exampleUseCases":[{"title":"Restore agent session state","prompt":"My AI agent saved its conversation state earlier under the key 'session-abc123' in the 'chat-sessions' namespace — can you retrieve that document so we can pick up where we left off?"},{"title":"Load workflow checkpoint","prompt":"Fetch the checkpoint data stored as 'pipeline-step-3' in the 'etl-workflow' namespace from Kiln Memory so the agent knows what was last processed."},{"title":"Recall user preference profile","prompt":"Retrieve the user preferences document saved under 'user-prefs-jane' in the 'personalization' namespace so the agent can tailor its responses accordingly."}],"resultDescription":"Returns the JSON document stored at the specified namespace and key. If the document exists and has not expired, the response includes the full JSON payload previously written. If the key does not exist or the TTL has elapsed, an appropriate error or empty response is returned.","failureModes":["Key not found – document was never written or has been deleted","TTL expired – document existed but its namespace TTL has elapsed","Namespace not found – the specified ns does not exist","Payment failure – x402 micropayment of $0.01 USDC not processed, request rejected","Invalid parameters – ns or key missing from query params","Rate limiting or service unavailability"],"whenToPreferThis":"Use this endpoint when an AI agent needs to read back a specific JSON document it (or another agent) previously persisted in Kiln Memory by namespace and key. Prefer this over generic key-value stores when you are already using Kiln Memory's TTL namespace model for agent state, checkpointing, or inter-agent communication, and need a pay-per-read micropayment-compatible retrieval mechanism.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:35:41.986Z","isFirstParty":false}