# Zep (/integrations/zep)





{/* MANUAL-CONTENT-START:intro */}

Use [Zep](https://getzep.com) 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.

{/* MANUAL-CONTENT-END */}

## Use the block [#usage-instructions]

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

## Actions [#actions]

### Create Thread [#create-thread]

Start a new conversation thread in Zep

<ReferenceDetails>
  #### Input [#input]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `threadId` | string | Yes | Unique identifier for the thread (e.g., "thread\_abc123") |
  | `userId` | string | Yes | User ID associated with the thread (e.g., "user\_123") |
  | `apiKey` | string | Yes | Your Zep API key |

  #### Output [#output]

  | Parameter | Type | Description |
  | - | - | - |
  | `threadId` | string | Thread identifier |
  | `userId` | string | Associated user ID |
  | `uuid` | string | Internal UUID |
  | `createdAt` | string | Creation timestamp (ISO 8601) |
  | `projectUuid` | string | Project UUID |
</ReferenceDetails>

### Get Threads [#get-threads]

List all conversation threads

<ReferenceDetails>
  #### Input [#input-1]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `pageSize` | number | No | Number of threads to retrieve per page (e.g., 10, 25, 50) |
  | `pageNumber` | number | No | Page number for pagination (e.g., 1, 2, 3) |
  | `orderBy` | string | No | Field to order results by (created\_at, updated\_at, user\_id, thread\_id) |
  | `asc` | boolean | No | Order direction: true for ascending, false for descending |
  | `apiKey` | string | Yes | Your Zep API key |

  #### Output [#output-1]

  | Parameter | Type | Description |
  | - | - | - |
  | `threads` | array | Array of thread objects |
  | ↳ `threadId` | string | Thread identifier |
  | ↳ `userId` | string | Associated user ID |
  | ↳ `uuid` | string | Internal UUID |
  | ↳ `createdAt` | string | Creation timestamp (ISO 8601) |
  | ↳ `updatedAt` | string | Last update timestamp (ISO 8601) |
  | ↳ `projectUuid` | string | Project UUID |
  | ↳ `metadata` | object | Custom metadata (dynamic key-value pairs) |
  | `responseCount` | number | Number of items in this response |
  | `totalCount` | number | Total number of items available |
</ReferenceDetails>

### Delete Thread [#delete-thread]

Delete a conversation thread from Zep

<ReferenceDetails>
  #### Input [#input-2]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `threadId` | string | Yes | Thread ID to delete (e.g., "thread\_abc123") |
  | `apiKey` | string | Yes | Your Zep API key |

  #### Output [#output-2]

  | Parameter | Type | Description |
  | - | - | - |
  | `deleted` | boolean | Whether the thread was deleted |
</ReferenceDetails>

### Get User Context [#get-user-context]

Retrieve user context from a thread with summary or basic mode

<ReferenceDetails>
  #### Input [#input-3]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `threadId` | string | Yes | Thread ID to get context from (e.g., "thread\_abc123") |
  | `mode` | string | No | Context mode: "summary" (natural language) or "basic" (raw facts) |
  | `minRating` | number | No | Minimum rating by which to filter relevant facts |
  | `apiKey` | string | Yes | Your Zep API key |

  #### Output [#output-3]

  | Parameter | Type | Description |
  | - | - | - |
  | `context` | string | The context string (summary or basic mode) |
</ReferenceDetails>

### Get Messages [#get-messages]

Retrieve messages from a thread

<ReferenceDetails>
  #### Input [#input-4]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `threadId` | string | Yes | Thread ID to get messages from (e.g., "thread\_abc123") |
  | `limit` | number | No | Maximum number of messages to return (e.g., 10, 50, 100) |
  | `cursor` | string | No | Cursor for pagination |
  | `lastn` | number | No | Number of most recent messages to return (overrides limit and cursor) |
  | `apiKey` | string | Yes | Your Zep API key |

  #### Output [#output-4]

  | Parameter | Type | Description |
  | - | - | - |
  | `messages` | array | Array of message objects |
  | ↳ `uuid` | string | Message UUID |
  | ↳ `role` | string | Message role (user, assistant, system, tool) |
  | ↳ `roleType` | string | Role type (AI, human, tool) |
  | ↳ `content` | string | Message content |
  | ↳ `name` | string | Sender name |
  | ↳ `createdAt` | string | Timestamp (RFC3339 format) |
  | ↳ `metadata` | object | Message metadata (dynamic key-value pairs) |
  | ↳ `processed` | boolean | Whether message has been processed |
  | `rowCount` | number | Number of rows returned |
  | `totalCount` | number | Total number of items available |
</ReferenceDetails>

### Add Messages [#add-messages]

Add messages to an existing thread

<ReferenceDetails>
  #### Input [#input-5]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `threadId` | string | Yes | Thread ID to add messages to (e.g., "thread\_abc123") |
  | `messages` | json | Yes | Array of message objects with role and content (e.g., \[\{"role": "user", "content": "Hello"}]) |
  | `apiKey` | string | Yes | Your Zep API key |

  #### Output [#output-5]

  | Parameter | Type | Description |
  | - | - | - |
  | `threadId` | string | Thread identifier |
  | `added` | boolean | Whether messages were added successfully |
  | `messageIds` | array | Array of added message UUIDs |
</ReferenceDetails>

### Add User [#add-user]

Create a new user in Zep

<ReferenceDetails>
  #### Input [#input-6]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `userId` | string | Yes | Unique identifier for the user (e.g., "user\_123") |
  | `email` | string | No | User email address |
  | `firstName` | string | No | User first name |
  | `lastName` | string | No | User last name |
  | `metadata` | json | No | Additional metadata as JSON object (e.g., \{"key": "value"}) |
  | `apiKey` | string | Yes | Your Zep API key |

  #### Output [#output-6]

  | Parameter | Type | Description |
  | - | - | - |
  | `userId` | string | User identifier |
  | `email` | string | User email address |
  | `firstName` | string | User first name |
  | `lastName` | string | User last name |
  | `uuid` | string | Internal UUID |
  | `createdAt` | string | Creation timestamp (ISO 8601) |
  | `metadata` | object | User metadata (dynamic key-value pairs) |
</ReferenceDetails>

### Get User [#get-user]

Retrieve user information from Zep

<ReferenceDetails>
  #### Input [#input-7]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `userId` | string | Yes | User ID to retrieve (e.g., "user\_123") |
  | `apiKey` | string | Yes | Your Zep API key |

  #### Output [#output-7]

  | Parameter | Type | Description |
  | - | - | - |
  | `userId` | string | User identifier |
  | `email` | string | User email address |
  | `firstName` | string | User first name |
  | `lastName` | string | User last name |
  | `uuid` | string | Internal UUID |
  | `createdAt` | string | Creation timestamp (ISO 8601) |
  | `updatedAt` | string | Last update timestamp (ISO 8601) |
  | `metadata` | object | User metadata (dynamic key-value pairs) |
</ReferenceDetails>

### Get User Threads [#get-user-threads]

List all conversation threads for a specific user

<ReferenceDetails>
  #### Input [#input-8]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `userId` | string | Yes | User ID to get threads for (e.g., "user\_123") |
  | `limit` | number | No | Maximum number of threads to return (e.g., 10, 25, 50) |
  | `apiKey` | string | Yes | Your Zep API key |

  #### Output [#output-8]

  | Parameter | Type | Description |
  | - | - | - |
  | `threads` | array | Array of thread objects |
  | ↳ `threadId` | string | Thread identifier |
  | ↳ `userId` | string | Associated user ID |
  | ↳ `uuid` | string | Internal UUID |
  | ↳ `createdAt` | string | Creation timestamp (ISO 8601) |
  | ↳ `updatedAt` | string | Last update timestamp (ISO 8601) |
  | ↳ `projectUuid` | string | Project UUID |
  | ↳ `metadata` | object | Custom metadata (dynamic key-value pairs) |
  | `totalCount` | number | Total number of items available |
</ReferenceDetails>