Skip to content

docs: Document session recording deletion and crypto-shredding#15324

Open
inkeep[bot] wants to merge 3 commits intomasterfrom
docs-writer-ai-update-2026-02-26T10-13-00-385Z-vdgizr
Open

docs: Document session recording deletion and crypto-shredding#15324
inkeep[bot] wants to merge 3 commits intomasterfrom
docs-writer-ai-update-2026-02-26T10-13-00-385Z-vdgizr

Conversation

@inkeep
Copy link
Contributor

@inkeep inkeep bot commented Feb 26, 2026

Summary

Documents the new session recording deletion capabilities introduced in PostHog/posthog#48420. This PR updates documentation to explain how session recordings can be permanently deleted using crypto-shredding.

Changes

contents/docs/session-replay/privacy.mdx

  • Added new "Data deletion" section explaining:
    • How crypto-shredding works (encryption keys are destroyed, making recordings permanently unreadable)
    • Two-phase deletion process (immediate key shredding + 10-day grace period for metadata cleanup)
    • Automatic deletion triggers (person deletion, team/project/org deletion)
    • What users see when viewing a deleted recording

contents/docs/privacy/data-storage.mdx

  • Updated the Persons row in the data deletion table to mention session recordings
  • Added delete_recordings=true parameter to all API examples
  • Added explanation of crypto-shredding for recordings

contents/docs/data/persons.mdx

  • Added note about deleting session recordings when deleting a person in the UI
  • Expanded API section to document delete_recordings=true parameter
  • Fixed broken link to data deletion docs

Related PRs


This PR was created by the Inkeep Content Writer agent, which is maintained by the Docs and Wizard team. Please reach out on Slack for help if needed.

inkeep bot added 3 commits February 26, 2026 10:14
…to privacy docs

Documents the recording deletion workflow introduced in PostHog/posthog#48420:
- Crypto-shredding (per-session key destruction)
- Two-phase deletion: key shredding + 10-day metadata cleanup
- Automatic deletion on person/team/project deletion
- Deleted recording player notice
Updates the data storage docs to reflect PR #48420 which adds the
`delete_recordings=true` parameter to the person deletion API. When
set, session recordings are permanently destroyed using crypto-shredding.

- Update Persons row in deletion table to mention session recordings
- Add `delete_recordings=true` to all API examples (bash, JS, Python)
- Add explanation of crypto-shredding behavior
- Document the option to delete session recordings when deleting a person in the UI
- Add `delete_recordings=true` API parameter documentation with crypto-shredding explanation
- Fix broken link from /docs/privacy/data-deletion to /docs/privacy/data-storage#data-deletion
@inkeep inkeep bot requested a review from TueHaulund February 26, 2026 10:18
@vercel
Copy link

vercel bot commented Feb 26, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
posthog Building Building Preview Feb 26, 2026 10:18am

Request Review

@github-actions
Copy link
Contributor

github-actions bot commented Feb 26, 2026

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Feb 26, 2026 10:24AM

@github-actions
Copy link
Contributor

Vale prose linter → found 0 errors, 4 warnings, 0 suggestions in your markdown

Full report → Copy the linter results into an LLM to batch-fix issues.

Linter being weird? Update the rules!

contents/docs/privacy/data-storage.mdx — 0 errors, 3 warnings, 0 suggestions
Line Severity Message Rule
33:7 warning 'anonymization' is a possible misspelling. PostHogBase.Spelling
89:19 warning Use 'ID' instead of 'Id'. Vale.Terms
113:49 warning Capitalize 'Endpoints' for PostHog's product. Use 'endpoints' for the general industry concept. PostHogBase.ProductNames
contents/docs/session-replay/privacy.mdx — 0 errors, 1 warnings, 0 suggestions
Line Severity Message Rule
43:1 warning Capitalize 'Session Replay' for PostHog's product. Use 'Session replay' for the general industry concept. PostHogBase.ProductNames

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant