---
title: "Restock a published limited collectible item by adding additional quantity."
method: POST
path: "/v1/collectibles/{collectibleItemId}/restock"
tags: ["Assets", "Avatars"]
---

# Restock a published limited collectible item by adding additional quantity.

`POST /v1/collectibles/{collectibleItemId}/restock`

## Request

- Base URL: `https://itemconfiguration.roblox.com`
- URL: `https://itemconfiguration.roblox.com/v1/collectibles/{collectibleItemId}/restock`
- Auth: one of:
  - API key in cookie `.ROBLOSECURITY`
  - API key in header `x-api-key`

## Path parameters

- `collectibleItemId` string, required

## Request body

- RobloxItemConfigurationApiModelsRequestCollectiblesRestockCollectibleItemRequest: Request model for restocking a collectible item.
  - `newTotalQuantity` integer: The new total quantity for the item after restocking.
  - `agreedRestockingFee` integer: The restocking fee the user agreed to pay.

## Response `200`

OK

- RobloxItemConfigurationApiModelsResponseCollectiblesRestockCollectibleItemResponse: Response model for restocking a collectible item.
  - `newTotalQuantity` integer: The new total quantity after restock.

## Other responses

- `400`: 37: Invalid CollectibleItemId. 137: The agreed restocking fee is invalid. 139: The additional quantity for restocking is invalid.
- `401`: 0: Authorization has been denied for this request. 66: Missing Authenticated User.
- `402`: 70: The user does not have enough Robux to pay
- `403`: 0: Token Validation Failed 12: User does not have permission for the group owned asset 18: User does not own the item 94: Actor is moderated. 106: Missing ID verification. 107: User's creation access is blocked. 108: Missing premium subscription tier. 109: Group owner missing premium subscription tier. 125: Missing two step verification. 136: Item is not eligible for restocking because it has been resellable.
- `404`: 3: Service Unavailable
- `500`: 38: Failed to get Collectible Item information. 56: Publishing Gateway returns unexpected exception. 103: Publishing gateway returns denied without any reason 104: Publishing gateway returns unexpected reason 105: Publishing gateway returns unexpected access status 138: Failed to restock the collectible item.

## Changes

- **2026-11-13** `e1e00fbc18e5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/roblox/apis/roblox-api/changes/v1/collectibles/:collectibleItemId/restock/post.md)

---

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