---
title: "Update product information about a published Collectible Item."
method: PATCH
path: "/v1/collectibles/{collectibleItemId}"
tags: ["Assets", "Avatars"]
---

# Update product information about a published Collectible Item.

`PATCH /v1/collectibles/{collectibleItemId}`

## Request

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

## Path parameters

- `collectibleItemId` string, required

## Request body

- RobloxItemConfigurationApiModelsRequestUpdateCollectibleItemRequest: Api request to update a collectible item.
  - `saleLocationConfiguration` RobloxItemConfigurationApiModelsRequestCollectiblesSaleLocationConfigurationModel: Model for Sale Location of Collectible Items.
    - `saleLocationType` 0 | 1 | 2 | 3 | 4: Roblox.ItemConfiguration.Api.Models.Request.CollectiblesSaleLocationConfigurationModel.CollectiblesSaleLocationType. ['SALE_LOCATION_TYPE_INVALID' = 0, 'SALE_LOCATION_TYPE_SHOP_AND_ALL_EXPERIENCES' = 1, 'SALE_LOCATION_EXPERIENCES_AND_DEV_API_ONLY' = 2, 'SALE_LOCATION_TYPE_SHOP_ONLY' = 3, 'SALE_LOCATION_TYPE_SHOP_AND_EXPERIENCES_BY_ID' = 4]
    - `places` integer[]: The list of PlaceIds this item is allowed to be sold in. This will be translated to UniverseIds inside the Collectibles Gateway. Requires Roblox.ItemConfiguration.Api.Models.Request.CollectiblesSaleLocationConfigurationModel.CollectiblesSaleLocationType set to ExperiencesById.
  - `isRentalOptIn` boolean: Whether the item is opted into rental.
  - `saleStatus` 0 | 1 | 2: The new sale status for the associated CollectibleItem. OnSale and OffSale are the only valid values. ['OnSale' = 0, 'OffSale' = 1, 'Free' = 2]
  - `quantityLimitPerUser` integer: The max number of instances for the CollectibleItem a user can own.
  - `resaleRestriction` 0 | 1 | 2: The resale restriction of the CollectibleItem. ['INVALID' = 0, 'NONE' = 1, 'DISABLED' = 2]
  - `priceInRobux` integer: The minimum price of the CollectibleItem.
  - `priceOffset` integer: The price offset of the item in Robux above the price floor.
  - `optOutFromRegionalPricing` boolean: Whether to opt out of the regional pricing.
  - `isFree` boolean: Whether or not the item is free. If it's free, the MinimumPrice and PriceOffset values are ignored.
  - `onSaleTime` string, date-time: Scheduled on sale time for publishing the item.
  - `offSaleTime` string, date-time: Scheduled off sale time for publishing the item.

## Response `200`

OK

## Other responses

- `400`: 1: Invalid target type 4: Invalid Argument 8: Missing/Null request parameters 23: No experiences were listed when trying to whitelist by Experience Ids 26: The upload content Name or Description was moderated. 37: Invalid CollectibleItemId. 59: Price offset is invalid. 60: Minimum price is invalid. 61: Invalid sale status. 65: Unexpected Place Ids. 76: The item is delisted. 79: Invalid Sale Location Update. 82: Invalid scheduled sale status. 85: OnSaleTime is in the past. 86: OffSaleTime is in the past. 87: OnSaleTime too far in the future. 88: OffSaleTime too far in the future. 89: OffSaleTime is before OnSaleTime. 90: Scheduled Time On Sale too short. 91: Scheduled Time Already Set. 92: Scheduled Time cannot set item on sale again. 93: Scheduled Time cannot set item off sale again. 146: Agreement is not publishable. 147: Resale is not allowed by the license. 148: Immediate on-sale is not allowed while the agreement is pending. 149: OnSaleTime is outside the agreement window. 150: OffSaleTime is outside the agreement window. 151: OffSaleTime is required for this agreement.
- `401`: 0: Authorization has been denied for this request. 66: Missing Authenticated User.
- `403`: 0: Token Validation Failed 12: User does not have permission for the group owned asset 18: User does not own the item 39: Group created items are currently not supported. 72: The Item is moderated. 74: The item's type is not allowed. 77: Resellable creation not allowed for user. 84: Scheduled publishing not enabled. 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.
- `404`: 3: Service Unavailable 5: Not Found 37: Invalid CollectibleItemId. 71: The Item is not found.
- `409`: 142: Resale is locked after restock.
- `412`: 75: The item has archived dependencies.
- `500`: 38: Failed to get Collectible Item information. 56: Publishing Gateway returns unexpected exception. 67: Invalid creator type 73: The Item's moderation status could not be determined. 144: Failed to get agreement. 145: Failed to get license.

## Changes

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

[Operation history](https://skmtc.dev/roblox/apis/roblox-api/changes/v1/collectibles/:collectibleItemId/patch.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)