---
search:
  tags:
    - Billing
    - POST
seo:
  description: >-
    Requires organization:update. Without a current… Reference for the POST
    /organizations/{organizationId}/billing/checkout endpoint in the Auth API.
sidebar:
  label: Subscribe, or change the plan or seats
  badge: POST
title: Subscribe, or change the plan or seats
type: openapi-operation
---
Requires organization:update. Without a current subscription, returns a Stripe Checkout URL. With one, returns a Stripe Customer Portal URL to confirm the change. Asking for the plan and seats already active answers 409. A plan billed per environment minute takes no seats, and the minutes used are billed at the end of each period. The subscription changes once Stripe confirms it, not when the browser returns.

`POST /organizations/{organizationId}/billing/checkout`

**Request body** (`application/json`, required)

- `plan` (string) — A plan name; the default plan when omitted.
- `seats` (integer) — Licensed environments, required by a plan priced per seat. A plan billed per environment minute ignores it.
- `return_url` (string<uri>, required) — A console URL Stripe returns to, whether the change completes or not.

Request body example:

```json
{
  "plan": "string",
  "seats": 1,
  "return_url": "http://example.com"
}
```

**Responses**

- `200` — The Stripe page to open.
- `default` — The request failed.

Response example, 200:

```json
{
  "url": "http://example.com"
}
```
