Skip to content
Try for free
On this page

Integrations

Zep

Long-term memory for AI agents

Use Zep to manage users, conversation threads, messages, and retrieved context across workflow runs. Add messages after an interaction, then retrieve user context for a later agent step.

Use the block

Integrate Zep for long-term memory management. Create threads, add messages, retrieve context with AI-powered summaries and facts extraction.

Actions

Create Thread

Start a new conversation thread in Zep

Inputs and outputs

Input

ParameterTypeRequiredDescription
threadIdstringYesUnique identifier for the thread (e.g., "thread_abc123")
userIdstringYesUser ID associated with the thread (e.g., "user_123")
apiKeystringYesYour Zep API key

Output

ParameterTypeDescription
threadIdstringThread identifier
userIdstringAssociated user ID
uuidstringInternal UUID
createdAtstringCreation timestamp (ISO 8601)
projectUuidstringProject UUID

Get Threads

List all conversation threads

Inputs and outputs

Input

ParameterTypeRequiredDescription
pageSizenumberNoNumber of threads to retrieve per page (e.g., 10, 25, 50)
pageNumbernumberNoPage number for pagination (e.g., 1, 2, 3)
orderBystringNoField to order results by (created_at, updated_at, user_id, thread_id)
ascbooleanNoOrder direction: true for ascending, false for descending
apiKeystringYesYour Zep API key

Output

ParameterTypeDescription
threadsarrayArray of thread objects
↳ threadIdstringThread identifier
↳ userIdstringAssociated user ID
↳ uuidstringInternal UUID
↳ createdAtstringCreation timestamp (ISO 8601)
↳ updatedAtstringLast update timestamp (ISO 8601)
↳ projectUuidstringProject UUID
↳ metadataobjectCustom metadata (dynamic key-value pairs)
responseCountnumberNumber of items in this response
totalCountnumberTotal number of items available

Delete Thread

Delete a conversation thread from Zep

Inputs and outputs

Input

ParameterTypeRequiredDescription
threadIdstringYesThread ID to delete (e.g., "thread_abc123")
apiKeystringYesYour Zep API key

Output

ParameterTypeDescription
deletedbooleanWhether the thread was deleted

Get User Context

Retrieve user context from a thread with summary or basic mode

Inputs and outputs

Input

ParameterTypeRequiredDescription
threadIdstringYesThread ID to get context from (e.g., "thread_abc123")
modestringNoContext mode: "summary" (natural language) or "basic" (raw facts)
minRatingnumberNoMinimum rating by which to filter relevant facts
apiKeystringYesYour Zep API key

Output

ParameterTypeDescription
contextstringThe context string (summary or basic mode)

Get Messages

Retrieve messages from a thread

Inputs and outputs

Input

ParameterTypeRequiredDescription
threadIdstringYesThread ID to get messages from (e.g., "thread_abc123")
limitnumberNoMaximum number of messages to return (e.g., 10, 50, 100)
cursorstringNoCursor for pagination
lastnnumberNoNumber of most recent messages to return (overrides limit and cursor)
apiKeystringYesYour Zep API key

Output

ParameterTypeDescription
messagesarrayArray of message objects
↳ uuidstringMessage UUID
↳ rolestringMessage role (user, assistant, system, tool)
↳ roleTypestringRole type (AI, human, tool)
↳ contentstringMessage content
↳ namestringSender name
↳ createdAtstringTimestamp (RFC3339 format)
↳ metadataobjectMessage metadata (dynamic key-value pairs)
↳ processedbooleanWhether message has been processed
rowCountnumberNumber of rows returned
totalCountnumberTotal number of items available

Add Messages

Add messages to an existing thread

Inputs and outputs

Input

ParameterTypeRequiredDescription
threadIdstringYesThread ID to add messages to (e.g., "thread_abc123")
messagesjsonYesArray of message objects with role and content (e.g., [{"role": "user", "content": "Hello"}])
apiKeystringYesYour Zep API key

Output

ParameterTypeDescription
threadIdstringThread identifier
addedbooleanWhether messages were added successfully
messageIdsarrayArray of added message UUIDs

Add User

Create a new user in Zep

Inputs and outputs

Input

ParameterTypeRequiredDescription
userIdstringYesUnique identifier for the user (e.g., "user_123")
emailstringNoUser email address
firstNamestringNoUser first name
lastNamestringNoUser last name
metadatajsonNoAdditional metadata as JSON object (e.g., {"key": "value"})
apiKeystringYesYour Zep API key

Output

ParameterTypeDescription
userIdstringUser identifier
emailstringUser email address
firstNamestringUser first name
lastNamestringUser last name
uuidstringInternal UUID
createdAtstringCreation timestamp (ISO 8601)
metadataobjectUser metadata (dynamic key-value pairs)

Get User

Retrieve user information from Zep

Inputs and outputs

Input

ParameterTypeRequiredDescription
userIdstringYesUser ID to retrieve (e.g., "user_123")
apiKeystringYesYour Zep API key

Output

ParameterTypeDescription
userIdstringUser identifier
emailstringUser email address
firstNamestringUser first name
lastNamestringUser last name
uuidstringInternal UUID
createdAtstringCreation timestamp (ISO 8601)
updatedAtstringLast update timestamp (ISO 8601)
metadataobjectUser metadata (dynamic key-value pairs)

Get User Threads

List all conversation threads for a specific user

Inputs and outputs

Input

ParameterTypeRequiredDescription
userIdstringYesUser ID to get threads for (e.g., "user_123")
limitnumberNoMaximum number of threads to return (e.g., 10, 25, 50)
apiKeystringYesYour Zep API key

Output

ParameterTypeDescription
threadsarrayArray of thread objects
↳ threadIdstringThread identifier
↳ userIdstringAssociated user ID
↳ uuidstringInternal UUID
↳ createdAtstringCreation timestamp (ISO 8601)
↳ updatedAtstringLast update timestamp (ISO 8601)
↳ projectUuidstringProject UUID
↳ metadataobjectCustom metadata (dynamic key-value pairs)
totalCountnumberTotal number of items available
Was this helpful?
Suggest an edit