{"uid":"cap_8l8Kca8XBum8xvD0w04N9","slug":"convrgent-ai-9b1cc5ed","name":"Convrgent AI Vault Profile Reader","description":"Retrieve a persistent human profile from the vault with all accumulated framework outputs, canonical traits, text history, and metadata.","url":"https://convrgent.ai/api/vault/read","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","bodyType","body","method"],"properties":{"body":{"required":["human_id"],"properties":{"include":{"type":"array","items":{"type":"string"},"description":"Framework keys to include (default: all)"},"human_id":{"type":"string","description":"Profile identifier to retrieve"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"name":"Alice Chen","human_id":"alice-chen-001","metadata":{"created":"2026-03-20T10:00:00Z","updated":"2026-03-20T14:30:00Z","signal_count":13},"frameworks":{"natal-chart":{"sunSign":"Gemini"},"communication":{"tone":"analytical-warm"}},"canonical_traits":[{"id":"introversion","value":0.72}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__ayZ_7YeZCwJQ-QpTKsFI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a persistent human profile from the vault including all accumulated framework outputs, canonical traits, conversation history, and metadata.","exampleAgentPrompt":"Pull up the full vault profile for the user with wallet address 0xAbC123 — I need all their accumulated framework outputs, canonical traits, and conversation history.","exampleUseCases":null,"resultDescription":"Returns the full persistent human profile object including all accumulated outputs from up to 11 personality frameworks (MBTI, Enneagram, Vedic astrology, Western astrology, Human Design, Chinese astrology, numerology, communication style, psychology, socionics, and cross-system convergence), canonical trait summaries, stored text/conversation history, agent briefing data, and profile metadata such as creation date and last update timestamp.","failureModes":["Profile not found for the given wallet address or ID — returns 404 or empty result","Invalid or missing wallet address / namespace — returns 400 validation error","Insufficient USDC balance or x402 payment failure — returns 402 payment required","Vault is empty or profile has no accumulated data yet — returns minimal or stub profile","Unauthorized agent namespace attempting to access another agent's profile — returns 403"],"whenToPreferThis":"Use this endpoint when you need to load a previously created and populated human profile from the Convrgent vault, especially when multiple framework outputs have already been accumulated over time. Prefer this over creating a new profile or running fresh analyses when the profile already exists and you want all cached traits, history, and cross-framework synthesis in one call. Ideal as a first step before personalizing communication, generating sales pitches, or running any Convrgent analysis that benefits from prior context.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:53:37.909Z","isFirstParty":false}