Skip to content

Document provisional browser cost estimates - #776

Closed
masnwilliams wants to merge 1 commit into
mainfrom
hypeship/browser-cost-estimates
Closed

masnwilliams wants to merge 1 commit into
mainfrom
hypeship/browser-cost-estimates

Conversation

@masnwilliams

@masnwilliams masnwilliams commented Nov 20, 2026 •

Copy link
Copy Markdown
Contributor

Hold: don't merge yet. This documents the include_cost parameter on GET /browsers/{id}, which isn't live until kernel/kernel#5670 is merged and deployed to production. The examples also need SDK 0.154.0, which adds include_cost. Merge after both.

Summary

Adds a Browser Cost Estimates page under Plans and Billing, after Pricing, covering:

  • how to request a cost estimate with include_cost (with include_deleted for deleted browsers), with TypeScript and Python examples
  • the cost object: status, estimated_usage_spend_usd (a decimal string) and as_of
  • what provisional, pending and unavailable mean and what to do for each
  • that it's an estimate at the org's current contract rate, excluding credits, commitments, subscription fees, tax and other invoice adjustments
  • that only flat contract rates are priced (tiered or percentage rates return unavailable)
  • how the estimate is calculated: GB-seconds of running time at the browser's memory allocation, standby excluded, GPU billed for its lifetime
  • when running and deleted browsers are priced

Validation

Rendered locally with mint dev. The page loads under Plans and Billing, and the code group, tables and anchors display correctly.


Note

Low Risk
Documentation and navigation only; no runtime or billing code changes in this PR.

Overview
Adds a Browser Cost Estimates doc under Plans and Billing (linked in docs.json after Pricing) for the upcoming include_cost option on single-browser retrieve.

The page explains how to request estimates (including deleted sessions with include_deleted), documents the cost object and provisional / pending / unavailable statuses, clarifies that figures are provisional usage at the org’s contract rate (not invoice totals), and describes GB-second pricing, standby/GPU billing behavior, and running vs deleted browser timing.

Reviewed by Cursor Bugbot for commit 20e7c46. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Nov 20, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
Kernel 🟢 Ready View Preview Nov 20, 2026, 9:09 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

@masnwilliams

Copy link
Copy Markdown
Contributor Author

Closing: no existing guide covers per-session browser cost, so no docs change is needed for include_cost. The API reference picks up the new parameter from the OpenAPI spec.

This branch was successfully deployed

1 active deployment
staging — 20e7c461 Deployed Nov 20, 2026 by mintlify[bot]
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