{"uid":"cap_MMSTdWdM1dbnI_wXtdbMX","slug":"agentic-endpoints-vault-retrieve-encrypted-item-2fb11df1","name":"Agentic Endpoints Vault - Retrieve Encrypted Item","description":"Retrieve an encrypted item from the vault (requires the namespace_token issued at claim time)","url":"https://agentic-endpoints-testnet.oliver-835.workers.dev/vault/retrieve","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"key":{"type":"string","description":"Item key to retrieve"},"namespace":{"type":"string","description":"Vault isolation scope"},"namespace_token":{"type":"string","description":"One-time token issued by the first /vault/store call that claimed this namespace"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NYviCtE2ym-ZUWnmZURaV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x036CbD53842c5426634e7929541eC2318f3dCF7e","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a previously stored encrypted item from a namespaced vault using the namespace token issued at claim time","exampleAgentPrompt":"Retrieve the encrypted item stored under the key 'api-credentials' in the 'myapp-prod' namespace of the vault — I have the namespace token 'tok_abc123xyz' from when I first claimed it.","exampleUseCases":[{"title":"Agent secrets retrieval at runtime","prompt":"Fetch the encrypted item with key 'db-password' from my vault namespace 'agent-prod' — use the namespace token 'tok_ns_9f8e7d6c' I saved when I set up the namespace."},{"title":"Multi-step workflow credential handoff","prompt":"I need to retrieve the value stored under the key 'stripe-api-key' in the 'payment-service' vault namespace so the next step in my workflow can use it — my namespace token is 'tok_claim_a1b2c3d4'."},{"title":"Secure configuration fetch for deployed agent","prompt":"Pull the encrypted config item with key 'openai-key' from vault namespace 'llm-agent' using namespace token 'tok_ns_zyx987wvu' and give me the decrypted value."}],"resultDescription":"The endpoint returns the encrypted item previously stored at the specified key within the given namespace. The caller receives the stored value (ciphertext or decrypted content depending on the vault implementation), validated against the namespace token to ensure only the authorized namespace owner can access it.","failureModes":["Invalid or expired namespace_token returns 401/403 unauthorized","Key not found in the specified namespace returns 404","Missing required parameters (key, namespace, or namespace_token) returns 400 bad request","Attempting to access a namespace that was never claimed returns an error","Payment failure or insufficient credit (x402 payment required) returns 402"],"whenToPreferThis":"Use this endpoint when you need to securely retrieve a value previously stored in the agentic vault and you hold the namespace_token issued at namespace claim time. This is the correct endpoint when you want read-only access to a vault item without deleting it. Prefer this over the delete endpoint when you want to preserve the stored item after retrieval, and over the key-exists check when you need the actual item content, not just its presence.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:41:36.020Z","isFirstParty":false}