Update an existing Product

Update an existing Product within your Hub

Utilize this endpoint to modify one or more attributes of an existing product within your hub, ensuring its details are current and accurate. This flexible tool allows for precise amendments, enhancing your product management workflow.

Update an existing Product

PATCH https://v2.parcelroblox.com/products/update/:product_id

Example of how you have to pass the body parameters:

Path Parameters

Name	Type	Description
product_id*	string	Product ID

Headers

Name	Type	Description
Authorization*	string	prod_DGzVhVsrqNJi4b0Chd9mMPUI9
Content-Type	string	application/json

Request Body

Name	Type	Description
name	string	Product Name
description	string	Product Description
developer_product_id	string	Roblox Developer Product ID
file	string	File URL (or text message)
onsale	boolean	Product Sale Status
role_id	string / null	Discord Buyer Role ID
decal_id	string / null	Roblox Decal ID
stock	string	Product Stock
category	string / null	Product Category
instructions	string / null	Product Delivery Instructions

200: OK

If everything was able to process properly:

{ "status": "200", "message": "OK", "data": { "state": "Product updated", "changes": object } }

400: Bad Request

If you did not follow the schema:

{ "status": "400", "message": "Your payload did not pass the Schema validation.", "error": string, "data": {} }

If the product name that you supplied is already registered:

{ "status": "400", "message": "The name '' is already in-use.\nPlease use a different product name.", "data": {} }

If the Roblox Developer Product ID that you supplied does not exist:

{ "status": "400", "message": "Developer Product ID could not be found.\nAre you sure that you've entered the correct developer product ID?\nPossible solution: Make sure the Developer Product exists in the Hub game.", "data": {} }

If you did not supply a Product Stock (Parcel Pro only):

{ "status": "400", "message": "Missing stock or invalid input. Please respond with a number between 0-999 or unlimited.", "data": {} }

If you the Product Stock you supplied is not within the number range (Parcel Pro only):

{ "status": "400", "message": "On the stock field, please respond with a number between 0-999.", "data": {} }

401: Unauthorized

If you provided an invalid authorization key:

{ "status": "401", "message": "Invalid authorization key." }

If you did not provide an authorization key:

{ "status": "401", "message": "No authorization key was provided." }

403: Forbidden

If your current tier does not support certain fields:

{ "status": "403", "message": "Access forbidden: Your tier (Parcel Free) does not allow configuring stock, instructions, or role_id.", "data": {} }

404: Not Found

If the product ID that you supplied does not exist:

{ "status": "404", "message": "Product does not exist.", "data": {} }

500: Internal Server Error

If something was wrong on our end:

{ "status": "500", "message": "Internal Server Error" }