---
title: "Update an organization price plan"
method: PATCH
path: "/v3/partner/organizations/{organizationId}/price-plan"
tags: ["partner"]
---

# Update an organization price plan

`PATCH /v3/partner/organizations/{organizationId}/price-plan`

## Request

- Base URL: `https://gateway.stage.bill.com/connect`
- URL: `https://gateway.stage.bill.com/connect/v3/partner/organizations/{organizationId}/price-plan`
- Auth: none declared

Update the price plan for an existing organization.

When you onboard as a BILL partner, BILL works with you to set up price plans for the organizations you create. Your organizations can have up to 5 price plans. Each price plan is named in the `PricePlanN` format (`PricePlan1` up to `PricePlan5`).

## Path parameters

- `organizationId` string, required: BILL-generated ID of the organization. The value begins with `008`.

## Headers

- `sessionId` string, nullable: API session ID generated with `/v3/partner/login`
- `appKey` string, nullable: Application key sent to you by BILL when you create a partner account

## Request body

- UpdateOrgPricePlanRequest: Update an organization price plan
  - `pricePlanType` 'PricePlan1' | 'PricePlan2' | 'PricePlan3' | 'PricePlan4' | 'PricePlan5', required: Price plan type

## Response `200`

Update an organization price plan response

- StatusDto: The type Delete response dto.
  - `status` 'SUCCESS' | 'FAILURE': Request status

## Other responses

- `4XX`: List of errors.
- `5XX`: List of errors.

---

[API](https://skmtc.dev/bill/apis/bill-v3-api.md) - [All operations](https://skmtc.dev/bill/apis/bill-v3-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bill/apis/bill-v3-api/revisions/54edddceb0a5?raw)