Skip to content

Commit f75c3fa

Browse files
hongyi-chenoz-agent
andcommitted
docs(pricing-may-2026): add billing subsection to agents.mdx (Agent identities)
Deferred from PR #112 (cross-page cleanup) because agents.mdx didn't exist on the umbrella branch at the time. Picked up after merging origin/main into the umbrella, which brought agents.mdx (added by PR #98 orchestration launch) into the tree. Adds a 'Billing for agent identity runs' subsection between 'Supporting multiple agent identities' and 'Plan limits' that mirrors the service-account billing waterfall on add-on-credits.mdx, credits.mdx, and team-access-billing-and-identity.mdx: - Self-serve (Build/Max/Business): bills the team owner. Waterfall is owner's plan-included credits, then owner's Reload credits, with auto-reload subject to the team-wide spend cap. - Enterprise: draws from the team-scoped credit pool with PAYG fallback when depleted, if enabled. Co-Authored-By: Oz <oz-agent@warp.dev>
1 parent 46bf04a commit f75c3fa

1 file changed

Lines changed: 9 additions & 0 deletions

File tree

  • src/content/docs/agent-platform/cloud-agents

src/content/docs/agent-platform/cloud-agents/agents.mdx

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,15 @@ You don't need to distinguish the two terms in day-to-day use — pick the agent
4141

4242
Most teams start with the default agent identity and add more as their automation matures. Creating additional agent identities is worth it when distinct workflows have meaningfully different scopes — for example, a `ci-runner` identity that only needs read-only repo access, an `on-call` identity that holds production deploy credentials and is restricted to incident playbooks, and a `nightly-jobs` identity used by scheduled cleanups. Scoping each identity to a single workflow gives every run the minimum credentials it needs, keeps audit trails attributable to the right bot, and lets you revoke or rotate one workflow's access without touching the rest.
4343

44+
## Billing for agent identity runs
45+
46+
Agent identity runs are not tied to an individual user, so they have no individual *task billing principal*. Warp resolves the billing principal based on your plan:
47+
48+
* **Self-serve plans (Build, Max, Business)** - Warp bills the **team owner**. The waterfall on the owner's account is: plan-included monthly credits, then the owner's Reload credits. Attribution stays on the agent identity that initiated the run, but billing rolls up to the owner. With auto-reload off, the request is blocked when both pools are depleted. With auto-reload on, agent identity usage can trigger a reload on the owner's pool subject to the team-wide monthly spend cap.
49+
* **Enterprise plans** - Agent identity runs draw from the team-scoped credit pool. When the pool is depleted, traffic falls to pay-as-you-go (PAYG) if enabled in the contract.
50+
51+
See [Reload credits](/support-and-community/plans-and-billing/add-on-credits/) for the full self-serve billing model and [Access, billing, and identity](/agent-platform/cloud-agents/team-access-billing-and-identity/) for the cross-plan credit precedence.
52+
4453
## Plan limits
4554

4655
Every team starts with a default agent identity. Additional identities are subject to plan-based limits — see [warp.dev/pricing](https://warp.dev/pricing) for current limits per plan.

0 commit comments

Comments
 (0)