{"uid":"cap_eQBWbd_0HT6F1X9Zu7X07","slug":"zenvault-key-value-vault-post-v1-vaults-f85e4cd6","name":"ZenVault Key-Value Vault (POST /v1/vaults)","description":"Key-value storage with TTL that survives your runs.","url":"https://api.zenvault.eu/v1/vaults?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_K5wreEMXJiLnNgnz9krRM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates a new key-value storage vault with TTL that persists data across agent runs, returning the created resource and a one-time management token.","exampleAgentPrompt":"Create a new ZenVault key-value vault to store my workflow state — it should expire after 24 hours and hold the current progress of my data pipeline job.","exampleUseCases":[{"title":"Persisting agent state mid-workflow","prompt":"Set up a persistent key-value vault that stores the current step and intermediate results of my multi-stage research task so I can resume it if the run crashes."},{"title":"Sharing data across agent sessions","prompt":"Create a ZenVault vault with a 48-hour TTL to hold the user preferences I've collected so far, so my agent can access them in the next session without re-asking."},{"title":"Temporary config store for a pipeline","prompt":"Provision a new vault to keep the API keys and config values my ETL pipeline needs — set it to expire in 6 hours once the job is done."}],"resultDescription":"Returns a JSON object containing the newly created vault resource (including vault ID, key-value contents, and expiry/TTL metadata) along with a one-time management token used to update or delete the vault later.","failureModes":["Invalid or missing TTL value returns a 400 error","Payment not included or insufficient USDC balance returns a 402 Payment Required","Malformed request body returns a 422 Unprocessable Entity","Vault quota exceeded for the account returns a 429 or 403","Service unavailability returns a 503"],"whenToPreferThis":"Choose this endpoint when your agent needs durable, cross-run state storage with automatic expiry — ideal for workflows that may crash and resume, multi-session data sharing, or temporary config/state that should self-clean via TTL. Prefer this over in-memory state when runs are non-contiguous, and over full databases when you need lightweight, ephemeral, managed storage without provisioning overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T03:21:13.718Z","isFirstParty":false,"canonicalSlug":"zenvault-key-value-vault-post-v1-vaults-f85e4cd6"}