Find session replays
posthog_replaysRetrieve session recordings for a user or device by distinct_id within a time window, ordered newest first, with direct links to watch each replay.
Instructions
Session recordings of one distinct_id in a time window, newest first, with links to watch them. Recordings older than the instance retention are gone. Naive timestamps are read in the project timezone.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"distinct_id": "<distinct_id>"
},
"name": "posthog_replays"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Window end, ISO 8601; defaults to now | |
| from | No | Window start, ISO 8601; defaults to 7 days before `to` | |
| limit | No | Maximum number of sessions | |
| project_id | No | Project id; defaults to POSTHOG_PROJECT_ID | |
| distinct_id | Yes | distinct_id of the person or device |