> ## 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. # Archive price book items > Archive multiple items within a specified price book in a single batch operation. This endpoint is useful for managing large sets of price book items that need to be archived simultaneously, streamlining the process and reducing the number of individual requests. > [accordion] Supported products > [accordion] Required Scopes ## OpenAPI ````yaml specs/2026-09/commerce-price-books-v2026-09.json POST /commerce/price-books/2026-09/price-books/{priceBookId}/items/batch/archive 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}/items/batch/archive: post: tags: - Batch summary: Batch archive price book items description: >- Archive multiple items within a specified price book in a single batch operation. This endpoint is useful for managing large sets of price book items that need to be archived simultaneously, streamlining the process and reducing the number of individual requests. operationId: >- post-/commerce/price-books/2026-09/price-books/{priceBookId}/items/batch/archive_/commerce/price-books/2026-09-beta/price-books/{priceBookId}/items/batch/archive parameters: - name: priceBookId in: path description: >- The unique identifier of the price book containing the items to be archived. required: true style: simple explode: false schema: type: integer format: int64 requestBody: content: application/json: schema: $ref: '#/components/schemas/BatchInputSimplePublicObjectId' required: true responses: '204': description: No content content: {} default: $ref: '#/components/responses/Error' description: '' security: [] components: schemas: BatchInputSimplePublicObjectId: required: - inputs type: object properties: inputs: type: array description: >- An array of SimplePublicObjectId objects, each representing a unique identifier for a public object. This property is required and is used to specify the objects involved in the batch operation. items: $ref: '#/components/schemas/SimplePublicObjectId' description: >- Represents a batch input payload containing a list of simple public object IDs. This component is used when performing batch operations on multiple objects within HubSpot. SimplePublicObjectId: required: - id type: object properties: id: type: string description: The unique identifier for this object, represented as a string. example: '430001' description: Contains the Id of a Public Object 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' ````