# Kiln Memory – Read Document

> Kiln Memory – Read Document is a paid API for AI agents from memory.fluidrack.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Retrieves a stored JSON document from a named TTL namespace in the Kiln durable memory store for AI agents.

## Facts

- Endpoint: GET https://memory.fluidrack.com/v1/ns/%7Bns%7D/docs/%7Bkey%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/kiln-memory-read-document-1e595561
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zpoeo7DqDaDVRMCLcl_1g

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability kiln-memory-read-document-1e595561
```

Example prompt: Pull up the document stored under key 'session-42' in the 'user-prefs' namespace from Kiln Memory.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Durable JSON memory store for AI agents with TTL namespaces.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/kiln-memory-read-document-1e595561/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from memory.fluidrack.com](https://www.zero.xyz/host/memory.fluidrack.com/llms.txt)