Repository navigation
docs(interact): document zero data retention sessions - #1584
Merged
Merged
Conversation
Interact accepts zeroDataRetention on POST /v2/interact and on
POST /v2/scrape/{scrapeId}/interact (firecrawl/firecrawl#4915). Document
how to enable it, the team-enablement requirement (403), the
recordings/profiles restriction (400), the 409 on an existing non-ZDR
session, inheritance from ZDR scrapes, and the url fallback when a ZDR
scrape's replay context is unavailable.
Interact ZDR pricing is intentionally left out pending a pricing decision.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013R47uwW8MefsRuLhpzaiq2
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Automations to automatically generate PRs for you. |
ZDR Interact sessions add 2 credits per browser minute: 4 credits/min for code-only sessions and 9 credits/min for prompt sessions, with the same one-minute minimum. A ZDR scrape keeps its own +1 credit/page surcharge. Depends on the Interact ZDR surcharge change in firecrawl/firecrawl. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013R47uwW8MefsRuLhpzaiq2
micahstairs
approved these changes
Oct 9, 2026
micahstairs
marked this pull request as ready for review
October 9, 2026 20:01
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Requested by Micah Stairs · Slack thread
Before: The docs said Zero Data Retention was available only for scrape and search. Nothing in the Interact or Browser pages, or in the Interact endpoint references, mentioned
zeroDataRetention, though the API has accepted it on Interact since early October.After:
features/interact.mdxhas a Zero Data Retention section. It covers how to enable ZDR onPOST /v2/scrape/{scrapeId}/interactandPOST /v2/interact, automatic ZDR when interacting with a ZDR scrape, the policy sticking to the session, the team-enablement requirement (403), the recordings/profiles restriction (400), the409when asking for ZDR on an existing non-ZDR session, and theurlfallback when a ZDR scrape's replay context is unavailable.features/browser.mdxgets a short ZDR subsection. The endpoint references (browser-create.mdx,scrape-execute.mdx) list the new parameters and error cases, andenterprise.mdxnow lists Interact among the ZDR surfaces. The pricing sections infeatures/interact.mdxandfeatures/browser.mdx, and the Interact row inbilling.mdx, now state the ZDR surcharge: +2 credits per browser minute, so code-only sessions bill at 4 credits/min and prompt sessions at 9, with the same one-minute minimum. A ZDR scrape still carries its own +1 credit/page surcharge.How: The support docs are checked against the API code that shipped in firecrawl/firecrawl#4915. The gating and the 403/409 errors are in
getBrowserZDR(apps/api/src/lib/browser-lifecycle.ts), the 400 for recordings/profiles is increateBrowserSession, the request fields are incontrollers/v2/browser.tsandcontrollers/v2/scrape-browser.ts, and ZDR scrapes skip the stored replay context inservices/logging/log_job.ts. Only the English source files are edited.The pricing depends on the API change in firecrawl/firecrawl (the ZDR surcharge PR, branch
claude/interact-zdr-surcharge). Onmaintoday, ZDR sessions bill at the standard 2 and 7 credits/min. Merge this after that change ships.🤖 Generated with Claude Code
https://claude.ai/code/session_013R47uwW8MefsRuLhpzaiq2