> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://help.getzep.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://help.getzep.com/_mcp/server.

# Get User Edges

POST https://api.getzep.com/api/v2/graph/edge/user/{user_id}
Content-Type: application/json

Returns all edges for a user.

Reference: https://help.getzep.com/sdk-reference/graph/edge/get-user-edges

## Request

### Path parameters

- `user_id` (string, required) — User ID

### Body (application/json)

This endpoint expects an apidata.GraphEdgesRequest.

- `limit` (integer, optional) — Maximum number of items to return
- `uuid_cursor` (string, optional) — UUID based cursor, used for pagination. Should be the UUID of the last item in the previous page

## Response

### 200

Edges

- `list of graphiti.EntityEdge`

## Errors

### 400 Bad Request Error

Bad Request

- `message` (string, optional)

### 500 Internal Server Error

Internal Server Error

- `message` (string, optional)

## Types

### graphiti.EntityEdge

- `created_at` (string, required) — Creation time of the edge
- `fact` (string, required) — Fact representing the edge and nodes that it connects
- `name` (string, required) — Name of the edge, relation name
- `source_node_uuid` (string, required) — UUID of the source node
- `target_node_uuid` (string, required) — UUID of the target node
- `uuid` (string, required) — UUID of the edge
- `attributes` (map from string to any, optional) — Additional attributes of the edge. Dependent on edge types
- `episodes` (list of string, optional) — List of episode ids that reference these entity edges
- `expired_at` (string, optional) — Datetime of when the node was invalidated
- `invalid_at` (string, optional) — Datetime of when the fact stopped being true
- `valid_at` (string, optional) — Datetime of when the fact became true

## Examples

**Request**

```json
{}
```

**Response**

```json
[
  {
    "created_at": "2024-05-20T10:15:30Z",
    "fact": "User A follows User B",
    "name": "follows",
    "source_node_uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "target_node_uuid": "b1c2d3e4-f5a6-7890-bcde-fa2345678901",
    "uuid": "c1d2e3f4-a5b6-7890-cdef-ab3456789012",
    "attributes": {},
    "episodes": [
      "episode-1234",
      "episode-5678"
    ],
    "expired_at": "2024-06-20T10:15:30Z",
    "invalid_at": "2024-06-20T10:15:30Z",
    "valid_at": "2024-05-20T10:15:30Z"
  }
]
```