Create resize

POST /v1/billing/subscriptions/{id}/resize

Changes a team's seats: how many standard and premium seats its next period opens at.

quantity is the subscription's own seat type, 0 to keep it, and lines each other seat type: {"lines":[{"planId":"team-premium","quantity":1}]} adds a premium seat to a team bought with standard ones. The renewal that opens the next period charges the seats asked for, and the period in hand keeps the ones it was paid for, so nothing is charged now. A team is at least 2 seats and at most 100 across every seat type; past either, or naming a plan that is not a seat type of the team, is 400 and nothing changes.

The team's seats are its admins' to change, and the platform's. A member is refused with 403 and told to ask an admin. A subscription from another org, or held by a wallet the caller may not change, is not found.

A named handler, not a closure, so zipdoc can lift this prose into the registry.

Request

5 fields, body application/json (required).

Response

200 body — 42 fields.

Failure carries the platform error shape — see Errors.

Examples

hanzo billing subscriptions resize <id>

import { Configuration, BillingApi } from 'hanzoai';

const api = new BillingApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.resizeSubscription({ id: 'id', lines: [{"planId":"<planId>","quantity":0}], quantity: 0 });

from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import BillingApi

client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = BillingApi(client).resize_subscription(id='id', lines=[{"planId":"<planId>","quantity":0}], quantity=0)

cfg := hanzoai.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := hanzoai.NewAPIClient(cfg)

resp, _, err := client.BillingAPI.ResizeSubscription(context.Background()).Execute()
if err != nil {
	return err
}

use hanzo_client::apis::{configuration::Configuration, billing_api};

let mut cfg = Configuration::new();
cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok();

let result = billing_api::resize_subscription(&cfg, Default::default()).await?;

import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.BillingApi;

ApiClient client = new ApiClient();
client.setBearerToken(System.getenv("HANZO_API_KEY"));

var result = new BillingApi(client).resizeSubscription();

curl -X POST https://api.hanzo.ai/v1/billing/subscriptions/<id>/resize \
  -H "Authorization: Bearer $HANZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
       "lines": [
         {
           "planId": "<planId>",
           "quantity": 0
         }
       ],
       "quantity": 0
     }'

curl -X POST https://api.hanzo.ai/v1/mcp \
  -H "Authorization: Bearer $HANZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "tools/call",
       "params": {
         "name": "billing",
         "arguments": {
           "op": "resizeSubscription",
           "input": {
             "id": "<id>",
             "lines": [
               {
                 "planId": "<planId>",
                 "quantity": 0
               }
             ],
             "quantity": 0
           }
         }
       }
     }'

Billing API · All Hanzo APIs · Interactive reference