{"uid":"cap_hX478yn2L9w8-CYrT4U1Q","slug":"convrgent-ai-43e4614a","name":"Convrgent Vault Profile Creator","description":"Create a new persistent human profile in the vault. Agent-namespaced by wallet address. Accepts initial identity, text samples, observations, and birth data.","url":"https://convrgent.ai/api/vault/create","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":{"name":{"type":"string"},"context":{"type":"object"},"human_id":{"type":"string","description":"Agent-chosen unique identifier for this human"},"birthData":{"type":"object","required":["year","month","day","location"],"properties":{"day":{"type":"integer"},"hour":{"type":"integer","description":"Highly recommended. Defaults to 12 if omitted."},"year":{"type":"integer"},"month":{"type":"integer"},"minute":{"type":"integer","description":"Defaults to 0 if omitted."},"latitude":{"type":"number","description":"Optional override"},"location":{"type":"string","description":"City and country. Coordinates auto-resolved."},"timezone":{"type":"number","description":"Optional — auto-resolved from location"},"longitude":{"type":"number","description":"Optional override"}}},"textSamples":{"type":"array","items":{"type":"object","required":["text"],"properties":{"text":{"type":"string"},"context":{"type":"string"}}}},"observations":{"type":"object"}}},"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":{"created":true,"human_id":"alice-chen-001","stored_signals":{"textSamples":1,"observations":0},"frameworks_computed":["natal-chart","communication"]}},"example":{"request":{"human_id":"alex_chen_sf_1988","frame_type":"price-increase","constraints":["Emphasize service improvements and expanded features","Acknowledge their loyalty and long-term partnership","Provide 30-day notice period"],"information":"We are implementing a new pricing structure that will increase costs by 15% effective next quarter","kyh_profile":{"birthDate":"1988-03-14","preferences":["data-driven arguments","transparency","long-term partnerships"],"birthLocation":"San Francisco","communicationStyle":"direct and analytical"},"desired_outcome":"zero-qa@agentmail.to","audience_context":"Long-term enterprise customer with data-driven decision-making preferences"},"response":{"status":"created","humanId":"alex_chen_sf_1988","version":1,"createdAt":"2026-06-16T01:17:10.551Z","frameworksComputed":[],"canonicalTraitCount":0}},"exampleRequest":{"human_id":"alex_chen_sf_1988","frame_type":"price-increase","constraints":["Emphasize service improvements and expanded features","Acknowledge their loyalty and long-term partnership","Provide 30-day notice period"],"information":"We are implementing a new pricing structure that will increase costs by 15% effective next quarter","kyh_profile":{"birthDate":"1988-03-14","preferences":["data-driven arguments","transparency","long-term partnerships"],"birthLocation":"San Francisco","communicationStyle":"direct and analytical"},"desired_outcome":"zero-qa@agentmail.to","audience_context":"Long-term enterprise customer with data-driven decision-making preferences"},"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Z1o943sLhj4AMzbkN-JxV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates a new persistent human personality profile in the Convrgent vault, namespaced to an agent's wallet address, seeded with identity data, text samples, observations, and birth data.","exampleAgentPrompt":"Create a new Convrgent vault profile for Alex Chen — here are some text samples from their messages, a few observations about their communication style, and their birth date is March 14 1988 in San Francisco.","exampleUseCases":null,"resultDescription":"Returns a newly created persistent vault profile record for the specified human, namespaced to the calling agent's wallet address, containing the initial identity, text samples, observations, and birth data provided. Subsequent calls to analysis endpoints can reference this profile.","failureModes":["Duplicate profile creation for same identity — may conflict or require update endpoint instead","Missing required identity or birth data fields — returns validation error","Invalid wallet address namespace — authorization failure","Malformed text samples or observations — parsing or ingestion error","Insufficient USDC balance for $0.01 fee — payment failure via x402"],"whenToPreferThis":"Use this endpoint when you need to initialize a brand-new persistent human profile in the Convrgent vault before running any personality, astrology, or communication analysis. This is the entry point — call it first before using update, psychological profile, MBTI, Vedic astrology, or communication adaptation endpoints. Prefer this over the update endpoint when the person does not yet have an existing vault record.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:50:27.883Z","isFirstParty":false}