---
title: "What changing plan would do, and cost today"
description: "Admins only."
canonical: "https://gtable.app/docs/builder-api/billing/preview"
updated: "2026-10-05"
---

# What changing plan would do, and cost today

`POST https://studio.gtable.app/v1/organizations/{organizationId}/billing/preview`

Admins only.

Changes nothing. Says whether the change is immediate (an upgrade, charged now and prorated, with Stripe's own figure for today), scheduled for the end of the paid period (a downgrade), or needs a checkout (no subscription yet). Refused with 501 while billing is not connected.

Requires the `account:read` scope. Operation `billing.preview`. MCP tool `billing_preview`. CLI, once published: `gtable billing preview`.

## Path parameters

| Name             | Type   | Required | Description |
| ---------------- | ------ | -------- | ----------- |
| `organizationId` | string | yes      |             |

## Headers

| Name              | Type   | Required | Description                                                                                                                                                                                                                                                        |
| ----------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Idempotency-Key` | string | no       | Any unique string. Sending the same key with the same request again returns the first response (marked `Idempotency-Replayed: true`) instead of running it twice. Reusing it for a different request is refused with 409. Kept for 24 hours. Up to 255 characters. |

## Request body

| Field      | Type                                      | Required | Description          |
| ---------- | ----------------------------------------- | -------- | -------------------- |
| `plan`     | "free" or "starter" or "team" or "custom" | yes      |                      |
| `interval` | "monthly" or "yearly"                     | no       | Default `"monthly"`. |