{"uid":"cap_zpoeo7DqDaDVRMCLcl_1g","slug":"kiln-memory-read-document-1e595561","name":"Kiln Memory – Read Document","description":"Durable JSON memory store for AI agents with TTL namespaces.","url":"https://memory.fluidrack.com/v1/ns/%7Bns%7D/docs/%7Bkey%7D","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_sNiCLCM_HHORKYnWlNRsY","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 named TTL namespace in the Kiln durable memory store for AI agents.","exampleAgentPrompt":"Pull up the document stored under key 'session-42' in the 'user-prefs' namespace from Kiln Memory.","exampleUseCases":[{"title":"Recall agent task state mid-workflow","prompt":"Fetch the JSON doc stored under key 'task-state' in my 'pipeline-v2' namespace so the agent can pick up where it left off."},{"title":"Load user preferences for personalization","prompt":"Read the document with key 'prefs' from the 'user-7891' namespace in Kiln Memory so you can tailor the response to their saved settings."},{"title":"Retrieve cached API response","prompt":"Get the document stored under key 'weather-cache' in the 'shared-cache' namespace — I want to check if we already fetched today's forecast before making another call."}],"resultDescription":"Returns the JSON document stored at the specified namespace and key combination, including any metadata such as TTL expiry. If the key does not exist or the namespace is invalid, an error response is returned.","failureModes":["Key not found – returns 404 if the document does not exist under the given ns/key combination","Namespace not found – returns 404 or error if the namespace has not been created","TTL expiry – document may have been deleted after its time-to-live elapsed","Authentication/payment failure – x402 payment of $0.01 USDC not accepted, returning 402","Malformed parameters – missing ns or key query params returns a 400 error"],"whenToPreferThis":"Use this endpoint when your AI agent needs to read durable, previously stored JSON state identified by a namespace and key — especially in multi-step workflows, session resumption, or personalization scenarios where state was written to Kiln Memory. Prefer over generic KV stores when TTL-scoped namespaces and per-call micropayment billing fit your architecture.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:31:15.923Z","isFirstParty":false}