# Convrgent.ai Vault Profile Update

> Convrgent.ai Vault Profile Update is a paid API for AI agents from convrgent.ai, paid per call via x402, $0.5/call, status unknown (last checked 2026-09-15).

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.

## Facts

- Endpoint: POST https://convrgent.ai/api/vault/update
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/convrgent-ai-26f74d64
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4Fw47pWcFw7DxUh-DPCsX

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability convrgent-ai-26f74d64 -d '<json body>'
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "updated": true,
  "human_id": "alice-chen-001",
  "total_signals": {
   "textSamples": 8,
   "observations": 5
  },
  "frameworks_recomputed": [
   "psych",
   "communication"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/convrgent-ai-26f74d64/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from convrgent.ai](https://www.zero.xyz/host/convrgent.ai/llms.txt)