Store a JSON document (object or string, up to 8 KB) on IPFS through a managed p
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.
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
POST https://enclave402.com/api/storage/pin
| Category | Commerce and shopping |
|---|---|
| Provider host | enclave402.com |
| Networks | eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 3 from 2 payers (the provider's figure, not ours) |
Our checks, last 30 days
We never call tools that send, buy, move money or file anything, not even without paying.
Example input (from the provider)
{
"body": {
"content": {
"agent": "planner-1",
"at": 1789650000,
"decision": "hold"
},
"name": "planner-1 decision"
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
Promised output schema (from the provider)
{
"$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"
}