> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.com/docs/llms.txt > Use this file to discover all available pages before exploring further. --- id: ad8f29ed-7448-435c-b326-24b39c946abb --- # Update a price book > Update an existing price book in your HubSpot account. This operation allows you to modify details such as the name, description, supported currencies, and custom properties of a price book. It is useful for keeping your price book information up to date with the latest changes. > [accordion] Supported products > [accordion] Required Scopes ## OpenAPI ````yaml specs/2026-09/commerce-price-books-v2026-09.json PATCH /commerce/price-books/2026-09/price-books/{priceBookId} openapi: 3.0.1 info: title: Commerce Price Books description: Basepom for all HubSpot Projects version: 2026-09 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE servers: - url: https://api.hubapi.com security: [] tags: - name: Advanced - name: Basic - name: Batch - name: Items paths: /commerce/price-books/2026-09/price-books/{priceBookId}: patch: tags: - Basic summary: Update price book description: >- Update an existing price book in your HubSpot account. This operation allows you to modify details such as the name, description, supported currencies, and custom properties of a price book. It is useful for keeping your price book information up to date with the latest changes. operationId: patch-/commerce/price-books/2026-09/price-books/{priceBookId} parameters: - name: priceBookId in: path description: The unique identifier of the price book to update. required: true style: simple explode: false schema: type: integer format: int64 requestBody: content: application/json: schema: $ref: '#/components/schemas/PriceBookUpdateRequest' required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/PriceBookResponse' default: $ref: '#/components/responses/Error' description: '' security: [] components: schemas: PriceBookUpdateRequest: required: - customProperties - description - name type: object properties: customProperties: type: object additionalProperties: type: string description: >- An object containing custom properties for the price book, where each key is a property name and the value is a string. description: type: object properties: {} description: >- An object representing the description of the price book to be updated. name: type: object properties: {} description: An object representing the name of the price book to be updated. supportedCurrencies: type: array description: >- An array of strings representing the currencies supported by the price book. items: type: string PriceBookResponse: required: - autoAssignmentEnabled - countOfIncludedProducts - customProperties - id - status - supportedCurrencies type: object properties: archived: type: boolean description: A boolean indicating whether this price book is archived. archivedAt: type: string description: The date and time when this price book was archived. format: date-time autoAssignmentEnabled: type: boolean description: >- Indicates whether auto-assignment is enabled for the price book. A boolean value. countOfIncludedProducts: type: integer description: The number of products included in this price book. format: int32 createdAt: type: string description: The date and time when this price book was created. format: date-time customProperties: type: object additionalProperties: type: string description: A map of custom property names to their values for this price book. description: type: string description: A description of the price book. id: type: string description: The unique identifier for this price book. name: type: string description: The name of the price book. status: type: string description: >- The current status of the price book. Valid values include 'ACTIVE' and 'INACTIVE'. enum: - ACTIVE - INACTIVE supportedCurrencies: type: array description: An array of currency codes that this price book supports. items: type: string updatedAt: type: string description: The date and time when this price book was last updated. format: date-time Error: required: - category - correlationId - message type: object properties: category: type: string description: The error category, represented as a string. context: type: object additionalProperties: type: array items: type: string description: >- An object providing context about the error condition. It contains additional properties, each being an array of strings. example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- A unique identifier for the request, represented as a UUID string. Include this value with any error reports or support tickets. format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: >- An array providing further information about the error, with each item being an ErrorDetail object. items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- An object that maps link names to associated URIs containing documentation about the error or recommended remediation steps. Each property is a string. message: type: string description: >- A human readable message describing the error along with remediation steps where appropriate. It is a string. example: An error occurred subCategory: type: string description: >- A specific category that contains more specific detail about the error, represented as a string. description: >- Represents an error response returned by the API when an operation fails. This component is used in various endpoints to provide detailed information about the error encountered. example: message: Invalid input (details will vary based on the error) correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf category: VALIDATION_ERROR links: knowledge-base: https://www.hubspot.com/products/service/knowledge-base ErrorDetail: required: - message type: object properties: code: type: string description: The status code associated with the error detail. context: type: object additionalProperties: type: array items: type: string description: >- Context about the error condition, which may include additional information such as missing scopes or invalid property names. example: '{missingScopes=[scope1, scope2]}' in: type: string description: The name of the field or parameter in which the error was found. message: type: string description: >- A human readable message describing the error along with remediation steps where appropriate. This is a required property. subCategory: type: string description: >- A specific category that contains more specific detail about the error. description: >- Represents detailed information about an error that occurred in the API. This component is used to provide additional context and specifics about errors, typically as part of an error response. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' ````