Skip to content

docs: fix worker billing, pod billing unit and job states - #870

Open
justinwlin wants to merge 3 commits into
mainfrom
docs/billing-and-job-states
Open

justinwlin wants to merge 3 commits into
mainfrom
docs/billing-and-job-states

Conversation

@justinwlin

@justinwlin justinwlin commented Sep 29, 2026 •

Copy link
Copy Markdown
Collaborator

Three pages contradict the rest of the docs and the API. This fixes them so each fact has one public answer.

  • Worker billing (serverless/workers/overview.mdx, serverless/pricing.mdx): the pricing page's "Start time: Initializing the container and loading models" read as if the worker table's Initializing state were billed, which it is not. Now both pages say the same thing: billing starts when a worker switches to Running and stops when it scales down. Image pull and cached-model downloads happen while Initializing and are not billed. Handler cold start, request processing and the idle timeout (shown as Running in the console) are billed.
  • Pod billing unit (pods/overview.mdx, get-started/products.mdx): "billed by the minute" → "billed by the second", matching Pod pricing and Billing.
  • Job states (serverless/endpoints/job-states.mdx): removes RUNNING. The job API reports IN_PROGRESS while a worker processes a job and never returns RUNNING.
  • Idle costs (get-started/products.mdx, serverless/overview.mdx): "no idle costs" → workers bill while they run and scale down to zero when there are no requests. The idle timeout after each request is billed.

@mintlify

mintlify Bot commented Sep 29, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated
runpod-docs 🟢 Ready View Preview Oct 3, 2026, 6:44 AM

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

This branch was successfully deployed

1 active deployment
staging — 6c5f0112 Deployed Oct 3, 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