Environment: ProductionEnvironment: Production USEnvironment: Test
API Reference

Create new product.

post
https://api-us.bluestonepim.com/pim/products

Creates a new product in the system. The product's ID is generated by Bluestone PIM and is included in the response headers under resource-id.

For more detailed information on how to work with new products in Bluestone PIM, refer to our help pages Create new products.

Variant Attribute Configuration Validation

When creating a product of type GROUP, variant-defining attributes must be properly configured. This error occurs when a product of type GROUP contains variant-defining attributes that are not configured to be propagated to its variants.

Attributes marked as definingAttributes, locked or mandatory require copy = true.

If copy is set to false (or omitted), the configuration becomes inconsistent and the request is rejected with HTTP 400 Bad Request. The response lists the attribute definition IDs that violate this rule.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
enum

Validation is used for specifying whether NUMBER, or NUMBER and NAME must be unique. NUMBER is the default validation. If NAME is specified, both NUMBER and NAME must be unique. If no number parameter is supplied in the body of the request, the assigned id will be used as the number.

Allowed:
Body Params
assets
array of strings
A value specifying the list of product assets id.
attributes
array of objects
A value specifying the list of product attributes.
categories
array of strings
A value specifying the list of product categories id.
string
labels
array of strings
A value specifying the list of product labels id.
string
required
string
string
enum
Allowed:
string
enum
Allowed:
Headers
string

Specifies the context in which to operate. If omitted, the default context en is used.

In Bluestone PIM, the context is generally synonymous with the language setting. The context determines how product information is tailored and presented based on language or other local specifications.

For more detailed information on how context relates to language settings in Bluestone PIM, refer to the Languages and Context documentation.

Note: The default context is identified by the ID "en". IDs for additional contexts begin with a lowercase "L", not with the digit "1", followed by a number. This naming convention helps distinguish between default and custom contexts within Bluestone PIM.

Responses

Updated about 1 month ago

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
*/*
application/json

Updated about 1 month ago