---
title: "Update organization billing group details"
method: PUT
path: "/organization/{organization_id}/billing-group/{billing_group_id}"
tags: ["OrganizationBillingGroup"]
---

# Update organization billing group details

`PUT /organization/{organization_id}/billing-group/{billing_group_id}`

## Request

- Base URL: `https://api.aiven.io/v1`
- URL: `https://api.aiven.io/v1/organization/{organization_id}/billing-group/{billing_group_id}`
- Auth: HTTP bearer and OAuth 2
  - Authorization code: `https://console.aiven.io/oauth/authorize`
  - Token URL: `https://api.aiven.io/v1/oauth2/token` scopes: `billing:write`

## Path parameters

- `organization_id` string, required
- `billing_group_id` string, required

## Request body

- OrganizationBillingGroupUpdateRequestBody: OrganizationBillingGroupUpdateRequestBody
  - `billing_address_id` string: Billing address ID
  - `billing_contact_emails` object[]: List of billing contact emails
    - `email` string, required: Email
  - `billing_emails` object[]: List of billing contact emails
    - `email` string, required: Email
  - `billing_group_name` string: Billing group name
  - `custom_invoice_text` string: Extra billing text
  - `payment_method` object: Payment method
    - `payment_method_id` string, required: Payment method ID
    - `payment_method_type` 'aws_subscription' | 'azure_subscription' | 'bank_transfer' | 'credit_card' | 'gcp_subscription' | 'custom', required: An enumeration.
  - `shipping_address_id` string: Shipping address ID
  - `vat_id` string: VAT ID

## Response `200`

Response

- OrganizationBillingGroupUpdateResponse: OrganizationBillingGroupUpdateResponse
  - `billing_address_id` string, required: Billing address ID
  - `billing_contact_emails` object[], required: List of billing contact emails
    - `email` string, required: Email
  - `billing_emails` object[], required: List of billing contact emails
    - `email` string, required: Email
  - `billing_group_id` string, required: Billing group ID
  - `billing_group_name` string, required: Billing Group Name
  - `create_time` string, required: The date when this billing group was created
  - `custom_invoice_text` string: Extra billing text
  - `organization_id` string, required: Organization ID
  - `payment_method` object: Payment method
    - `payment_method_id` string, required: Payment method ID
    - `payment_method_type` 'aws_subscription' | 'azure_subscription' | 'bank_transfer' | 'credit_card' | 'gcp_subscription' | 'custom', required: An enumeration.
  - `shipping_address_id` string, required: Shipping address ID
  - `vat_id` string: VAT ID

## Other responses

- `403`: Operation not allowed
- `404`: Resource not found

## Changes

- **2026-09-21** `7f378868f351`: 2 breaking, 2 info
  - removed the enum value `aws_subscription_v1` of the request property `payment_method/payment_method_type`
  - removed the enum value `gcp_subscription_v1` of the request property `payment_method/payment_method_type`
  - removed the `aws_subscription_v1` enum value from the `payment_method/payment_method_type` response property for the response status `200`
  - removed the `gcp_subscription_v1` enum value from the `payment_method/payment_method_type` response property for the response status `200`
- **2026-09-09** `c3d7cd304ef2`: 2 warning, 2 info
  - added the new `aws_subscription_v1` enum value to the `payment_method/payment_method_type` response property for the response status `200`
  - added the new `gcp_subscription_v1` enum value to the `payment_method/payment_method_type` response property for the response status `200`
  - added the new `aws_subscription_v1` enum value to the request property `payment_method/payment_method_type`
  - added the new `gcp_subscription_v1` enum value to the request property `payment_method/payment_method_type`
- **2026-07-26** `b262b3b4c127`: 1 info
  - added the non-success response with the status `403`
- **2026-07-13** `9b2b0f1b0fa9`: 1 info
  - added the required property `create_time` to the response with the `200` status
- **2026-05-20** `b3fa0d3f099f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/aiven/apis/aiven-api-documentation/changes/organization/:organization_id/billing-group/:billing_group_id/put.md)

---

[API](https://skmtc.dev/aiven/apis/aiven-api-documentation.md) - [All operations](https://skmtc.dev/aiven/apis/aiven-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/aiven/apis/aiven-api-documentation/revisions/562453405db0?raw)