{"uid":"cap_ZwFtWr9hFMghwUODUIOIX","slug":"vaaya-zep-memory-search-dd34eae5","name":"Vaaya Zep Memory Search","description":"Give an AI agent a credit account. Set a limit and a spending policy, and the agent makes approved, metered purchases from providers that accept Vaaya.","url":"https://vaaya.ai/api/run/zep/search","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["query","user_id"],"properties":{"limit":{"type":"integer","maximum":50,"exclusiveMinimum":0},"query":{"type":"string","minLength":1},"scope":{"enum":["edges","nodes","episodes"],"type":"string"},"user_id":{"type":"string","minLength":1}},"additionalProperties":true},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"pathParams":{"type":"object"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_BE4t-WjrbGqU9iu7rrIMY","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":"Searches a user's Zep memory graph for relevant nodes, edges, or episodes using a natural language query","exampleAgentPrompt":"Search user 'user_abc123' in Zep memory for anything related to 'project deadlines', looking through nodes, and return up to 10 results.","exampleUseCases":[{"title":"Recall user preferences for personalization","prompt":"Search Zep memory for user 'user_42' for anything related to 'dietary preferences' — return up to 5 nodes so I can personalize their meal recommendations."},{"title":"Find past conversation context","prompt":"Look up what we've previously discussed about 'contract renewal' for user 'user_789' in Zep memory, searching episodes and returning up to 20 results."},{"title":"Retrieve relationship data from knowledge graph","prompt":"Query user 'user_001's Zep memory graph for edges related to 'company partnerships', limit to 15 results."}],"resultDescription":"Returns a list of matching memory entries (nodes, edges, or episodes) from the user's Zep memory graph that are semantically relevant to the provided query, based on the selected scope.","failureModes":["Missing required 'query' field returns validation error","Missing 'user_id' returns validation error","Invalid 'scope' enum value causes rejection","Empty or whitespace-only query rejected (minLength:1)","Limit exceeds maximum of 50 causes schema validation error","User ID not found in Zep returns empty results","Payment not included or insufficient USDC balance causes 402 error"],"whenToPreferThis":"Use this endpoint when an AI agent needs to retrieve relevant memory context for a specific user from a Zep memory graph — especially when you need to search across nodes, edges, or episodes using natural language. Prefer this over generic vector search when you already have a user_id and want to leverage Zep's structured memory model with scoped retrieval.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:44:07.580Z","isFirstParty":false}