{"uid":"cap_-cqGcaGKjHDg4WSWGtqcu","slug":"api-mnemospark-ai-06ef858d","name":"MnemoSpark Lite File Upload","description":"OpenClaw plugin for encrypted cloud backup and agent-driven storage. Circle USDC on Coinbase Base (Ethereum L2) via x402—wallet-native, no API keys.","url":"https://api.mnemospark.ai/api/mnemospark-lite/upload","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["filename","contentType","tier","size_bytes"],"properties":{"tier":{"enum":["10mb","100mb","500mb","1gb","2gb","3gb"],"type":"string","description":"Upload pricing/size tier"},"filename":{"type":"string","description":"Single file name"},"size_bytes":{"type":"integer","maximum":4800000000,"minimum":0,"description":"Declared upload size in bytes"},"contentType":{"type":"string","description":"MIME type"}},"additionalProperties":false},"type":{"const":"http"},"method":{"const":"POST"},"bodyType":{"const":"json"}},"additionalProperties":false},"output":{"type":"object","required":["type","example"],"properties":{"type":{"const":"json"},"example":{"type":"object"}},"additionalProperties":true}},"additionalProperties":false},"responseSchema":{"type":"json","example":{"data":{"maxSize":100000000,"siteUrl":null,"uploadId":"abc123","expiresAt":"2026-05-23T12:00:00Z","publicUrl":null,"uploadUrl":"https://s3-presigned.example/...","curlExample":"curl -X PUT --data-binary @\"example.pdf\" ...","completion_token":"opaque-token","list_scope_bearer":"opaque-bearer"},"success":true,"metadata":{"price":"$0.02","network":"eip155:8453","payment":{"status":"verified","success":true,"transactionHash":null},"protocol":"x402"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.65","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":"$1.3/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1.3","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1.3","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_l-8jgE3ycmxDlqxTmMtI4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1.3","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Initiates a wallet-scoped file upload session, returning a presigned S3 URL, completion token, and bearer token for subsequent file listing and downloads; files expire after 30 days.","exampleAgentPrompt":"Upload my project-report.pdf to MnemoSpark Lite temporary storage so I can share it for the next 30 days — give me back the presigned upload URL and the bearer token I'll need to list and download it later.","exampleUseCases":null,"resultDescription":"Returns a presigned S3 upload URL to PUT the file to, a completion token to confirm the upload, and a bearer token for authenticating subsequent listing and download requests. The stored file will automatically expire and be deleted after 30 days.","failureModes":["Payment not provided or insufficient USDC (402 Payment Required)","Wallet not authorized or invalid wallet address (401 Unauthorized)","File size exceeds allowed limit (413 Payload Too Large)","Presigned URL generation failure due to S3 backend error (500 Internal Server Error)","Request malformed or missing required fields (400 Bad Request)","Rate limit exceeded for wallet (429 Too Many Requests)"],"whenToPreferThis":"Choose this endpoint when you need temporary (30-day), wallet-scoped cloud file storage with a presigned S3 upload flow and need bearer-authenticated access to list and download files afterward. Ideal for agentic workflows where files need to be shared or retrieved later without long-term storage commitments and where payment is handled via x402/USDC.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:37:24.827Z","isFirstParty":false}