Create new catalog or category.

This endpoint allows you to create a new catalog or category within Bluestone PIM. The new catalog or category 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 catalogs and categories in Bluestone PIM, refer to our help pages Create and manage catalogs and categories.

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

Validation type for the request. If NAME is used, the Default is empty value.

Validation strategy for the creation operation. Can be either NAME or empty value and defaults to empty value.

NAME means that a validation check will be performed to make sure that no other catalog/category exist with the same name.

Empty value can be used to create a catalog/category with the same name as another existing catalog/category.

Note: The number must always be unique.

Example: NAME

Allowed:
Body Params
string
required
length between 1 and 1000

Specifies the name of the category (catalog node).

string
length between 0 and 1000

Specifies the number of the category (catalog node). This value must be unique across all catalogs and categories in Bluestone PIM. If not specified, the system will use the category ID, which is a unique identifier generated by the system, as the default category number.

string

Specifies the ID of the parent category (catalog node) to which this category belongs.

Example: 634c26e14cedfd0001775e9f

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.

string

Specifies whether to enable the fallback mechanism for the context. If omitted, the default value true will be used. When set to true, the system will provide a default translation or relevant information if the requested context's specific translation is missing.

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

Note: Setting the context-fallback parameter to false disables the fallback mechanism. In this configuration, if a translation or specific context information is not available, the system will not provide an alternative or default content. This ensures that only content that matches the exact context ID requested is returned, potentially leading to cases where no content is available if the specific translation is missing.

Responses

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