{"uid":"cap_pezlhKMf3WEfhI4VqGXj1","slug":"convrgent-ai-b2ce43fd","name":"Convrgent AI Vault — List Human Profile IDs","description":"List all human profile IDs stored in the vault for this agent. Returns IDs and metadata without full profile data.","url":"https://convrgent.ai/api/vault/list","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":{"properties":{"limit":{"type":"integer","description":"Max profiles to return (default: 50)"},"offset":{"type":"integer","description":"Pagination offset (default: 0)"}}},"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":{"total":2,"profiles":[{"name":"Alice Chen","created":"2026-03-20T10:00:00Z","human_id":"alice-chen-001","signal_count":13},{"name":"Bob Smith","created":"2026-03-19T08:00:00Z","human_id":"bob-smith-002","signal_count":5}]}},"example":{"request":{"birth_date":"1990-06-15"},"response":{"status":"success","agentId":"0x9CC42f3d9245B867ACccd630B43f906c1665b176","profiles":[{"humanId":"alex_chen_sf_1988","version":1,"createdAt":"2026-06-16T01:17:10.551Z","updatedAt":"2026-06-16T01:17:10.551Z","frameworkCount":0,"textSampleCount":0}],"profileCount":1}},"exampleRequest":{"birth_date":"1990-06-15"},"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tUF9OUn-r6NLgFmqUkBGU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all human profile IDs and their metadata stored in the agent's namespaced vault, without returning full profile data.","exampleAgentPrompt":"Show me all the human profiles stored in my vault — just the IDs and metadata, not the full profile data.","exampleUseCases":null,"resultDescription":"A list of all profile IDs stored in the agent's wallet-namespaced vault, along with lightweight metadata for each entry (such as creation timestamps, labels, or partial identifiers), but without the full psychological or personality profile payloads.","failureModes":["Empty vault returns an empty list rather than an error","Invalid or missing wallet address returns authorization error","Vault namespace not found returns 404 or empty response","Payment failure (x402) results in 402 response before list is returned","Rate limiting may return 429 if called in rapid succession"],"whenToPreferThis":"Use this endpoint when an agent needs to discover which human profiles exist in its vault before deciding which full profile to fetch or update. Ideal as a prerequisite step before calling profile-fetch or update endpoints. Prefer this over full profile endpoints when you only need to check existence, count entries, or display a directory of tracked individuals.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:41:01.588Z","isFirstParty":false}