The GraphQL schema changelog is a list of all upcoming and previous updates to the GA and Preview GraphQL schemas. It also includes announcements for deprecated, retired, and decommissioned (breaking) functionality.
The Inventory Sync GraphQL API was promoted from Preview to Early Availability status.
New Checkout GraphQL APIs were released to support end-to-end self-serve checkout. These APIs enable customers to create a truly headless checkout experience.
The following changes were made to Product GraphQL APIs:
New mutation (triggerProductPublicationProcess) - initiates the product publication process for one or multiple products and returns the productPublicationProcesses object, which includes the status, trigger date, and errors if the process fails.
New mutation (productPublicationProcess) - allows users to track the publication process of a product by process ID.
The following changes were made to the schema:
Updated the ProductImage object to support product profile images.
Updated pricing plan APIs:
New error message for invalid grace period units.
New field modifiedBy added to the updatePriceBookCondition mutation- email ID of the user modifying the pricing.
New field removedBy added to the removeConditionProperties mutation - email ID of the user removing any properties.
The following new Product GraphQL APIs were released in the Early Availability status:
Create the product shell
Create editions
Create pricing plans
New enums PricingFeeType and PricingVersionType were added for pricing plan APIs.
The following changes were made:
New webhook objects were added.
New error types were added to the product API schema.
The union UpdateEditionPricingError and the following error types were added to the pricing plan APIs:
PricingPlanTerminationFeeValueError
DuplicateUnitForIncludedItemsError
InvalidUnitsForIncludedItemsError
A new field PRODUCT_CUSTOM_ATTRIBUTE was added to the DownloadEntityType enum.
The product integration GraphQL APIs were moved to the Early Availability (EA) phase from preview.
The union UpdateProductEditionErrors and the object ProductEditionFeature were added to the product API schema.
The deprecated fields state and tag were removed from the Product Information Management (PIM) GraphQL APIs.
New Serialized Fulfillment GraphQL APIs were released. With these changes, GraphQL APIs support a Serialized Fulfillment system that can track individually identified items within a shipment of physical products.
The following changes were made:
Several improvements were made for the pricing plan APIs.
New fields and options were added to the accounts query and object. With these additions, the accounts query supports new filters to further refine results.
Additionally, the AccountAccessType enum supports the new values: NON_CHANNEL_ADMIN and NON_VENDOR.
The accountsorderBy field allows for DATE and NAME.
New mutations were added that allow a Marketplace Manager or Reseller Manager to assign an account to a Reseller as a client, or to remove such an assignment.
New queries were added to allow searching for account memberships involving resellers.
The following changes were made:
New fields (idpID and username) were added to the updateUser mutation in Preview status.
New fields that capture contact details were added to the User and Account objects, also in Preview status.
The following areas were updated:
Account Association
Notifications
Price Book
Products
The following changes were made:
Updated pricing plan APIs to support context to fetch pricing plan details, define developer and markup prices for flat fee, and update pricing details.
New fields were added to the userActivity object and query.
Several authorizations in the Price Book API were updated to include ROLE_PARTNER.
The following updates were made:
The ProductEdition object now includes a name field when it is returned in a query.
The createProduct mutation accepts additional input fields (name, description, shortDescription).
New queries and mutations support Inventory records for physical products.
New queries and mutations allow users to view and modify notification templates.
The following updates were made:
New mutations and queries were added to support custom prices.
Several elements of the existing Price Book API were updated.
The name attribute of the Product object changed type.
The following updates were made:
The productId attribute was added as a required attribute for the updateProductEdition mutation.
A new Shared integration configurations topic was added under the Product management guide.
The following new features were added:
New mutations for variant options, variant option values and variant creation.
A new query for the marketplace product.
The following updates were made:
Two items within the Product Associations API were renamed.
A new query allows users to retrieve currency exchange rates.
The following updates were made:
New standard attributes were added to the Account and User objects.
Account and User objects can now include custom attributes.
The mutations and queries for Account and User objects include the new attributes in the payload.
A new mutation allows users to update an Insights dataset.
Insights datasets include a new revision attribute, which stores a new type of object.
The following update was made:
The queries and mutations related to pricing plans were updated to allow null values in certain fields.
The following new features were added:
A new mutation for deleting accounts was added.
New fields in user definitions were made available for update using an existing mutation.
The following updates were made:
Some price book items were promoted from Preview to Early Availability status for all customers on the AWS-US and AWS-EU clusters.
The queries and mutations related to price book conditions were updated to include segment information.
The following updates were made:
Existing User, Account, and Account Membership mutations were made available in Preview status for all customers.
Existing User, Account, and Account Membership queries were promoted to Generally Available (GA) status for all customers. The GraphQL Explorer and Schema Introspection tools were similarly promoted to GA for all customers.
Marketplace Managers were given access to a new Enable GraphQL Mutations setting to manage whether users can execute GraphQL mutations that change marketplace data in the AppDirect GraphQL Explorer.
New Account Membership mutations were added in Preview status for all customers. The following tasks are supported:
Create a new Account Membership that links a User with an existing Account, with or without an invitation being sent to the user's email address.
Delete an existing Account Membership.
Update roles assigned to Users within Account Memberships
The following updates were made:
Selected Objects, Input Objects, and Enums related to Product APIs were renamed to conform to standards.
The API was updated to inherit the vendorId parameter from the client making an API call, rendering this parameter optional.
The authorization rules for Product APIs were added to the reference documentation.
Selected price book schema mutations and queries (added June 17, 2021) were promoted from Preview to Early Availability status. The updated items support the following tasks:
Retrieve a specific price book by ID, pricing plan ID, or by name.
Retrieve a specific price book condition.
Retrieve a specific price book entry.
Create a new price book, price book condition, or price book entry
Update an existing price book
A query was added in Early Availability (EA) status for AWS-US and AWS-EU customers:
Retrieve all price books.
The user, account, and account membership queries were made available in Early Availability status to customers on the AWS-EU cluster. The GraphQL Explorer and Schema Introspection tools were also made available in Early Availability status to customers on the AWS-EU cluster.
Additions were made to the Account object and associated schema items, also in Early Availability status for AWS-US and AWS-EU customers. The following have been added:
The Account object includes a countryCode attribute.
The AccountAccessType enum includes two new possible values: REFERRAL and CUSTOMER.
New user, account, and account membership mutations were added in Preview status for customers on both the AWS-US and the AWS-EU clusters. The following tasks are supported:
Create a new Account
Update an existing Account
Update an existing User
Activate or deactivate an existing Account Membership
New Subscription mutations and a query were made available in Early Availability status to customers on the AWS-EU cluster. The following tasks are supported:
Terminate a subscription by changing its status to can celled, without triggering vendor notifications.
Create a price change with a price definition on an existing subscription.
Retrieve an upcoming price change operation for an existing subscription by subscription ID.
New queries and mutations were added to support the creation of Product Associations between existing product editions. The following tasks are supported:
Create a product association between a specific edition of a product, and editions of other products that it requires.
Remove a specific product association between an edition and other product editions.
Retrieve a list of all product associations that a given product edition has to editions of other products that it requires
The GraphQL Explorer and Schema Introspection tools became available in Early Availability status to customers on the AWS-US cluster.
The GraphQL Explorer is a browser-based tool that simplifies the construction of GraphQL queries and mutations.
The GraphQL Schema Introspection tool provides documentation of the GraphQL schema within the GraphQL Explorer.
The user queries and account queries from the releases transitioned from Preview status to Early Availability status for customers on the AWS-US cluster.
Addition of account membership, Search feed resources, and Insights queries to the EA schema. The following tasks are supported:
Retrieve a specific account membership by user ID and account ID
Retrieve a list of account memberships by account ID
Retrieve a list of account memberships by user ID
Retrieve the current or most recently used account membership by user ID
Retrieve the user definition for the current user
Retrieve Search feed resources for the current user
Create an Insights dataset
Push data to an Insights dataset
Create a metric for an Insights dataset
Retrieve an Insights dataset by ID
Retrieve a metric for an Insights dataset by ID
Retrieve a metric by ID
Addition of user queries to the Preview schema. The following tasks are supported:
Retrieve a user by AppDirect ID.
Retrieve a user by external ID.
Retrieve a user by username
Retrieve a list of all users.
Addition of account (company) queries to the Preview schema. The following tasks are supported:
The terminology was changed. Instead of "company", the term "account" is now used.
Retrieve an account by AppDirect ID.
Retrieve an account by external ID.
Retrieve a list of all accounts.
Addition of price book mutations and queries to the Preview schema. The following tasks are supported:
Create, update, and delete price books.
Create, update, and delete price book conditions.
Create, update, and delete price book entries.
Retrieve price books.
Initial release of the Preview schema. The following tasks are supported:
Create new products in the staging catalog.
Read products.
Request product publication to the production catalog.