---
title: "Upgrade Team Plan"
method: POST
path: "/billing/team/{team_id}/upgrade-plan"
tags: ["billing"]
---

# Upgrade Team Plan

`POST /billing/team/{team_id}/upgrade-plan`

Upgrade a team's plan directly without Stripe Checkout.

Requires the team to already have a payment method on file. Creates a
Stripe subscription for the target plan price. Optionally applies a
promotion code.

## Path parameters

- `team_id` string, required

## Request body

- UpgradeTeamPlanRequest — Request for direct team plan upgrade (no Checkout redirect).
  - `plan` 'pro' | 'enterprise', required — Target plan to upgrade to
  - `promotion_code` string, nullable — Optional Stripe promotion code to apply

## Response `200`

Successful Response

- UpgradeTeamPlanResponse — Response for direct team plan upgrade.
  - `success` boolean, required
  - `plan` string, required
  - `message` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/pioneer/apis/brain-api.md) · [All operations](https://skmtc.net/pioneer/apis/brain-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pioneer/brain-api/versions/31dfe831e079/schema)