GraphQL types of the Sphere schema that are shared across multiple types and operations.
KeyReference
key field. If available, the key is immutable and mandatory. KeyReferences do not support Reference Expansion.typeIdString | Type of referenced resource. |
keyString | User-defined unique and immutable key of the referenced resource. |
KeyReferenceInput
Reference
id. The typeId indicates the type of the referenced resource. Each resource type has its corresponding Reference type, like ChannelReference. A referenced resource can be embedded through Reference Expansion. The expanded reference is the value of an additional obj field then.typeIdString | Type of referenced resource. |
idString | Unique ID of the referenced resource. |
ReferenceExpandable
idString |
ReferenceInput
typeIdString | |
idString |
ResourceIdentifier
id or (wherever supported) the key of the resource to reference, but depending on the API endpoint the response returns either a Reference or a KeyReference. For example, the field parent of a CategoryDraft takes a ResourceIdentifier for its value while the value of the corresponding field of a Category is a Reference.typeIdString | Type of referenced resource. If given, it must match the expected ReferenceTypeId of the referenced resource. |
keyString | User-defined unique identifier of the referenced resource. Required if id is absent. |
idString | Unique identifier of the referenced resource. Required if key is absent. |
ResourceIdentifierInput
typeIdString | |
idString | |
keyString |
HighPrecisionMoney
Object that stores money as a fraction of the smallest indivisible unit of a specific currency.
typeString | Type of money used. |
currencyCode | A currency code compliant with ISO 4217 or a non-standard currency. |
preciseAmountLong | Amount in 1 / (10 ^ fractionDigits) of a currency. |
centAmountLong | Amount in the smallest indivisible unit of a currency, such as:
centAmount is represented as 64-bit integers. If this limit is exceeded, a MoneyOverflow error will be returned. |
fractionDigitsInt | Number of digits after the decimal separator, greater than the default number of fraction digits for a currency. |
Date
Time
DateTime
YearMonth
Country
Currency
CurrencyCode
Locale
LocalizedEnumValueDraft
keyString | |
labelArray of LocalizedStringItemInputType |
LocalizedString
locale | |
valueString |
LocalizedStringItemInputType
locale | |
valueString |
Address
An address represents a postal address.
idString | Unique identifier of the Address. It is not recommended to set it manually since the API overwrites this ID when creating an Address for a Customer.
Use key instead and omit this field from the request to let the API generate the ID for the Address. |
streetNameString | Name of the street. |
streetNumberString | Street number. |
additionalStreetInfoString | Further information on the street address. |
postalCodeString | Postal code. |
cityString | Name of the city. |
regionString | Name of the region. |
stateString | Name of the state, for example, Colorado. |
country | Name of the country. |
companyString | Name of the company. |
departmentString | Name of the department. |
buildingString | Number or name of the building. |
apartmentString | Number or name of the apartment. |
pOBoxString | Post office box number. |
additionalAddressInfoString | Further information on the Address. |
externalIdString | ID for the contact used in an external system. |
keyString | User-defined identifier of the Address. Must be unique among the addresses in a BusinessUnit, Customer, or in the itemShippingAddresses (LineItem-specific addresses) of a Cart, Order, QuoteRequest, or Quote. |
phoneString | Phone number of the contact. |
mobileString | Mobile phone number of the contact. |
emailString | Email address of the contact. |
faxString | Fax number of the contact. |
titleString | Title of the contact, for example 'Dr.' |
salutationString | Salutation of the contact, for example 'Mr.' or 'Ms.' |
firstNameString | Given name (first name) of the contact. |
lastNameString | Family name (last name) of the contact. |
custom | Custom Fields defined for the Address. |
AddressDraft
custom field in addition to the fields of a BaseAddress.idString | Unique identifier of the Address. It is not recommended to set it manually since the API overwrites this ID when creating an Address for a Customer.
Use key instead and omit this field from the request to let the API generate the ID for the Address. |
streetNameString | Name of the street. |
streetNumberString | Street number. |
additionalStreetInfoString | Further information on the street address. |
postalCodeString | Postal code. |
cityString | Name of the city. |
regionString | Name of the region. |
stateString | Name of the state, for example, Colorado. |
country | Name of the country. |
companyString | Name of the company. |
departmentString | Name of the department. |
buildingString | Number or name of the building. |
apartmentString | Number or name of the apartment. |
pOBoxString | Post office box number. |
additionalAddressInfoString | Further information on the Address. |
externalIdString | ID for the contact used in an external system. |
keyString | User-defined identifier of the Address. Must be unique among the addresses in a BusinessUnit, Customer, or in the itemShippingAddresses (LineItem-specific addresses) of a Cart, Order, QuoteRequest, or Quote. |
custom | Custom Fields defined for the Address. |
phoneString | Phone number of the contact. |
mobileString | Mobile phone number of the contact. |
emailString | Email address of the contact. |
faxString | Fax number of the contact. |
titleString | Title of the contact, for example 'Dr.' |
salutationString | Salutation of the contact, for example 'Mr.' or 'Ms.' |
firstNameString | Given name (first name) of the contact. |
lastNameString | Family name (last name) of the contact. |
AddressInput
idString | |
titleString | |
salutationString | |
firstNameString | |
lastNameString | |
streetNameString | |
streetNumberString | |
additionalStreetInfoString | |
postalCodeString | |
cityString | |
regionString | |
stateString | |
country | |
companyString | |
departmentString | |
buildingString | |
apartmentString | |
pOBoxString | |
phoneString | |
mobileString | |
emailString | |
faxString | |
additionalAddressInfoString | |
externalIdString | |
keyString | |
custom |
Asset
idString | Unique identifier of the Asset. Not required when importing Assets using the Import API. |
keyString | User-defined identifier of the Asset. It is unique per Category or ProductVariant. |
sourcesArray of AssetSource | |
nameString | Name of the Asset. |
nameAllLocalesArray of LocalizedString | Name of the Asset. |
descriptionString | Description of the Asset. |
descriptionAllLocalesArray of LocalizedString | Description of the Asset. |
tagsArray of String | Keywords for categorizing and organizing Assets. |
custom | Custom Fields defined for the Asset. |
AssetSource
uriString | URI of the AssetSource. |
keyString | User-defined identifier of the AssetSource. Must be unique per Asset. |
dimensions | Width and height of the AssetSource. |
contentTypeString | Indicates the type of content, for example application/pdf. |
AssetDimensions
widthInt | |
heightInt |
Image
urlString | URL of the image in its original size that must be unique within a single ProductVariant. |
dimensions | Dimensions of the original image. |
labelString | Custom label for the image. |
Dimensions
widthInt | |
heightInt |
CustomFieldsCommand
typeIdString | |
typeKeyString | |
fieldsJson | |
typeResId |
CustomFieldsType
typeRef | |
type | |
customFieldsRawArray of RawCustomField | This field contains non-typed data. |
CustomFieldInput
A key-value pair representing the field name and value of one single custom field.
The value of this custom field consists of escaped JSON based on the FieldDefinition of the Type.
value:- FieldType
String:"\"This is a string\"" - FieldType
DateTimeType:"\"2018-10-12T14:00:00.000Z\"" - FieldType
Number:"4" - FieldType
Setwith an elementType ofString:"[\"This is a string\", \"This is another string\"]" - FieldType
Reference:"{\"id\": \"b911b62d-353a-4388-93ee-8d488d9af962\", \"typeId\": \"product\"}"
nameString | |
valueString | The value of this custom field consists of escaped JSON based on the FieldDefinition of the Type. Examples for
value:
|
CustomFieldsDraft
typeIdString | |
typeKeyString | |
type | |
fieldsArray of CustomFieldInput |
RawCustomField
nameString | |
valueJson | |
referencedResource | |
referencedResourceSetArray of ReferenceExpandable |
Initiator
isPlatformClientBoolean | |
clientIdString | |
externalUserIdString | |
anonymousIdString | |
customerRef | |
userRef | |
associateRef | |
attributedTo |
Attribution
clientIdString | |
source | Can be Export, Import, IntakeAgent, ManagedCommerceMCP, ProductEnrichmentAgent, PromotionsAgent, or StarterAgent |
userRef |
AttributionSource
ExportImportIntakeAgentManagedCommerceMCPProductEnrichmentAgentPromotionsAgentStarterAgent