{"uid":"cap_GsVHQv8WkjkJX7R29yFD9","slug":"vaaya-zep-add-append-messages-to-a-zep-memory-thread-3411a730","name":"Vaaya Zep Add — Append Messages to a Zep Memory Thread","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/add","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":["thread_id","messages"],"properties":{"messages":{"type":"array","items":{"type":"object","required":["role","content"],"properties":{"name":{"type":"string"},"role":{"type":"string","minLength":1},"content":{"type":"string"}},"additionalProperties":false},"minItems":1},"thread_id":{"type":"string","minLength":1},"return_context":{"type":"boolean"}},"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_hG8c4Z8MhLvDfUFbHlfM6","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":"Appends one or more messages to a named Zep memory thread so that agent conversation history is persisted and retrievable across sessions.","exampleAgentPrompt":"Add these two messages to my Zep memory thread 'user-session-42': a user message saying 'What is the status of my order?' and an assistant message saying 'Your order is currently being processed.' — and return the updated context.","exampleUseCases":[{"title":"Persist multi-turn agent conversation","prompt":"Save the latest exchange to my Zep thread 'support-chat-88': the user said 'Can I get a refund?' and the assistant replied 'Yes, refunds are processed within 5 business days.' Return the updated context so I can use it in the next turn."},{"title":"Log onboarding dialogue to memory","prompt":"Append these messages to Zep thread 'onboarding-flow-user-17': user message 'What features does the Pro plan include?' and assistant message 'The Pro plan includes unlimited exports, priority support, and advanced analytics.'"},{"title":"Store background research turns for research agent","prompt":"Add a new assistant message to Zep thread 'research-agent-session-3' with the content: 'I found that global EV adoption grew 35% year-over-year in 2023.' — the role should be assistant."}],"resultDescription":"Returns a confirmation that the messages were appended to the specified Zep thread. If return_context is true, the response also includes the updated thread context object containing the full conversation history and any derived memory facts.","failureModes":["Missing thread_id or empty string — 400 validation error","Empty messages array or messages with missing role/content — 400 validation error","Thread does not exist — may create a new thread or return 404 depending on Zep backend configuration","Invalid bodyType — request rejected before reaching Zep","Payment failure (x402) — call not executed, 402 response returned","Network timeout to upstream Zep service — 503 or timeout error"],"whenToPreferThis":"Use this endpoint when your AI agent needs to persist conversation turns to a Zep-backed long-term memory store without setting up a Zep account or API key directly. Ideal for agents already using the Vaaya platform that want managed memory append operations at $0.01 per call. Prefer this over direct Zep SDK calls when you want zero-config memory persistence inside a Vaaya agent workflow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:51:47.933Z","isFirstParty":false}