This API allows clients to create new domains or update existing ones in Product Content Cloud (PCC). It supports sending domain definitions, attribute schemas, records, metadata, and digital assets in a single payload. This endpoint is used for onboarding new domain configurations, maintaining domain content, and synchronizing external master data into PCC.
Request Body Parameters
domainName (string)
It defines what the domain represents (such as “Supplier”, “Packaging Specs”, or “Nutritional Claims”) and acts as the primary label under which all of the domain’s attributes, records, and digital assets are organized.
This is the key identifier for the domain.
domainNameBaseLocale (string)
Language/locale for the domain name (e.g., "en_us").
Useful for multi-language implementations.
isRestrictedValueList (string)
Indicates whether attribute values must come from a predefined LOV (List of Values)
"true"→ Must use LOV
"false"→ Free-text values allowed
Datatype: ("true/false", though logical boolean)
product360DisplayLocation (string)
Specifies the section or tab in the Product360 screen of the PCC system where the domain’s information such as attributes and records belonging to this domain is displayed.
Examples: "Individual Tab" or "Common Tab".
PCCKeyDomainIdentifier (number)
Unique internal identifier for the domain inside PCC (Product Content Cloud).
Domain Attribute Schema (domainAttributes)
Datatype: Array<DomainAttributes>
Each DomainAttribute object includes:
attributeName (string)
The name of the attribute that belongs to this domain.
Example: “Supplier ID”, "Supplier Name".
attributeDataType (string)
Expected datatype of the attribute.
Common values: "String", "Number", "DateTime".
attributeConstraintIsRequired (string)
Whether this attribute must be provided in every record.
Datatype: String ("true" / "false")
attributeConstraintEnforceDataType (string)
Whether the value must strictly match the defined datatype.
Datatype: String ("true" / "false")
attributeConstraintAllowMultivalue (string)
Specifies whether the attribute supports multiple values for one record.
Datatype: String ("true" / "false")
attributeConstraintEnforceListOfValue (string)
Whether only allowed values from an attribute LOV can be used.
Datatype: String ("true" / "false")
Domain Records (domainRecords)
Datatype: Array<DomainRecord>
Each DomainRecord object includes the following parameters:
domainRecord (string)
Primary unique identifier for the record (e.g., "SUP-001").
Often acts like a key or record name.
recordAttributes Array<RecordAttribute>
Actual values assigned to the attribute schema defined earlier.
Each RecordAttribute contains:
attributeName (string)
Name of the attribute being set.
attributeData (string)
Actual assigned value for the record.
Successful response
Response Body Parameters
Your response contains a single top-level object with one property:
responseSummary (object)
Contains a summary of the domain-loading operation, including counts of successes, failures, updates, and lists of affected domains.
Below is each parameter inside responseSummary, described with datatype + meaning:
Count of Domains Sent In Payload (number)
Total number of domains that were included in the input POST payload.
Count of DomainsSuccessfully Loaded into PCC (number)
Number of domains that were successfully processed (inserted or updated) in the Product Content Cloud (PCC).
Count of Domains which Errored Entirely (number)
Number of domains that failed completely — meaning no part of the domain could be processed.
Count of Domains which Errored Partially (number)
Number of domains that were only partially processed due to record or attribute-level errors.
Count of Domains Newly Added (number)
Number of domains that were created for the first time in PCC.
Count of Domains Updated (number)
Number of domains that already existed and were updated, not newly created.
Count of Domains New DA (number)
Count of domains for which new Digital Assets (DA) were added during the operation.
Newly Added Domains (Array<string>)
List of domain names that were newly added in this operation.
Updated Domains (Array<string>)
List of domain names that were updated.
Example: "Supplier", "Domain Name"