{"slug":"enclave402-com-api-storage-pin-e72211","title":"Store a JSON document (object or string, up to 8 KB) on IPFS through a managed p","host":"enclave402.com","method":"POST","resource":"https://enclave402.com/api/storage/pin","category":"commerce","description":"Store a JSON document (object or string, up to 8 KB) on IPFS through a managed pinning service and return its content identifier (CID v1) plus an HTTP gateway URL. MUST be invoked when an agent needs durable, content-addressed storage for memory, decisions, artifacts or metadata that other agents ca","price_listed":0.008,"price_asked":null,"state":"effects","state_label":"Not tested: has real-world effects","checks_7d":0,"answered_7d":0,"latency_ms_median":null,"reported_calls_30d":3,"reported_payers_30d":2,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"content":{"agent":"planner-1","at":1789650000,"decision":"hold"},"name":"planner-1 decision"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"content":{"description":"JSON object or string to store (serialized size up to 8 KB).","examples":[{"agent":"planner-1","at":1789650000,"decision":"hold"}],"type":["object","string"]},"name":{"description":"Optional human label stored with the pin.","maxLength":120,"type":"string"}},"required":["content"]},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"additionalProperties":false,"properties":{"cid":{"description":"IPFS CID of the stored content","type":"string"},"gateway":{"description":"Resolvable HTTP gateway URL for the CID","type":["string","null"]},"pinned":{"description":"true when the provider accepted and pinned the content","type":"boolean"},"provider":{"description":"Pinning provider","type":"string"},"settled":{"description":"true when an x402 payment settled for this response","type":"boolean"},"size":{"description":"Pinned size in bytes as reported by the provider","type":"integer"},"status":{"description":"Provider pin status (pinned)","type":"string"},"ts":{"description":"Response timestamp, UNIX milliseconds","type":"integer"}},"required":["pinned","cid","provider","status","settled","ts"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[],"description_full":"Store a JSON document (object or string, up to 8 KB) on IPFS through a managed pinning service and return its content identifier (CID v1) plus an HTTP gateway URL. MUST be invoked when an agent needs durable, content-addressed storage for memory, decisions, artifacts or metadata that other agents can fetch by CID. Do NOT send raw binary, files over 8 KB, or an existing CID to re-pin. Settles $0.008 USDC via x402 on Base; failed or unavailable pins are never charged; receipts at /api/ledger.","last_updated":"2026-09-19T06:02:07.108Z","schemes":["exact"]}