{"uid":"cap_4Fw47pWcFw7DxUh-DPCsX","slug":"convrgent-ai-26f74d64","name":"Convrgent.ai Vault Profile Update","description":"Update an existing vault profile with new signals — text samples, observations, birth data. Auto-merges with existing data, re-runs affected personality engines, recomputes canonical traits.","url":"https://convrgent.ai/api/vault/update","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":{"context":{"type":"object"},"human_id":{"type":"string","description":"Profile identifier to update"},"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":{"updated":true,"human_id":"alice-chen-001","total_signals":{"textSamples":8,"observations":5},"frameworks_recomputed":["psych","communication"]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","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.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_faqlWkgTTd46uO90k_144","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Updates an existing persistent personality vault profile with new signals (text, observations, birth data), auto-merging data and re-running affected personality engines to recompute canonical traits.","exampleAgentPrompt":"I just got more text samples and some new observations about Alex — can you update their existing vault profile on Convrgent with these signals and re-run the personality engines to get fresh trait scores?","exampleUseCases":null,"resultDescription":"Returns the updated vault profile with auto-merged signals, re-run personality engine outputs, and recomputed canonical trait scores across behavioral dimensions reflecting the newly incorporated data.","failureModes":["Vault profile ID not found — returns 404 if the target profile does not exist","Invalid or malformed signal data — returns 400 if text samples or observations fail validation","Conflicting birth data — engine may flag inconsistency if new birth data contradicts existing records","Partial merge failure — one or more personality engines may fail to recompute if input is insufficient","Authentication failure — wallet-namespaced profile not accessible with provided credentials"],"whenToPreferThis":"Use this endpoint when you already have an existing vault profile and want to incrementally improve it with new signals rather than creating a new profile from scratch. Prefer this over the create endpoint when the subject already exists in the vault. Use when you have new text samples, fresh observations, or corrected birth data that should update previously computed personality traits.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:44:12.760Z","isFirstParty":false}