10/30/2026, 12:00:43 AM
Developers can now filter many queries by creation date: cashTrackingSessions, deliveryCustomizations, inventoryShipments, marketingEvents, staffMembers, cashActivities (on CashDrawer, PointOfSaleDevicePaymentSession, CashTrackingSessions), and the ExchangeV2 and Return connections now support a "created_at" filter. A number of sort key enums received new options (e.g. CREATED_AT) and the FulfillmentTrackingInfo company list was extended with additional carriers, with automatic status updates clearly documented. FileContentType now includes DIRECTORY and FilesErrorCode gained many directory‑related errors such as BLANK, WRITE_RESTRICTED_FILES_REQUIRED, and BATCH_DIRECTORY_MUTATION_NOT_ALLOWED. The Metaobject type now exposes a non‑nullable compareDigest field, and the mutations metaobjectUpdate and metaobjectUpsert accept a compareDigest argument to guard against stale data. New object types were added for partner account linking, including AgenticExternalAccount and ExternalAccountSetPayload, and a new mutation automationTestEventUpdate lets clients rename or update test events. The fileDelete mutation now accepts a list of "paths" in addition to file IDs for bulk deletions. Additional fields appear on AnalyticsSchemaEventFieldScope (eventLabels, validApiClientIds), and BusinessCustomerErrorCode gains a new MANAGED_BY_APP value. Finally, the removed exchangeV2s field is deprecated, with the new “returns” field now offering a richer filter set inclusive of created_at.
Returns a shop's cash tracking sessions for locations with a POS Pro subscription.
Tip: To query for cash tracking sessions in bulk, you can
perform a bulk operation.
The delivery customizations.
Returns a paginated list of InventoryShipment objects.
Supports filtering by barcode (e.g. barcode:"12345"), status (e.g. status:"draft" or status:"in_transit"), and destination (e.g. destination_id:12345).
A list of marketing events associated with the marketing app.
The payment customizations.
A list of point of sale device payment sessions in the shop. Cash management data is returned only for locations with a POS Pro subscription.
Returns a paginated list of StaffMember objects for the shop. Staff members are users who can access the Shopify admin to manage store operations.
Supports filtering by account type, email, and name, with an option to sort results. The query returns a StaffMemberConnection for cursor-based pagination.
Renames a test event or replaces its trigger parameters. Updating a captured test event converts it to custom and counts toward the custom test event limit.
Links a partner account to the shop's enrollment for the agentic channel that the calling app links. Every call sends the account's ID and name, and Shopify stores the name with the ID. Use null as the accountId to clear the link. An account that this mutation links replaces an account that Shopify matched automatically, and an automatic match never replaces it.
Deletes file assets that were previously uploaded to your store.
Use the fileDelete mutation to permanently remove media and file assets from your store when they are no longer needed.
This mutation handles the complete removal of files from both your store's file library and any associated references
to products or other resources.
The fileDelete mutation supports removal of multiple file types:
When you delete files that are referenced by products, the mutation automatically removes those references and
reorders any remaining media to maintain proper positioning. Product file references are database relationships
managed through a media reference system, not just links in product descriptions. The Shopify admin provides a UI
to manage these relationships, and when files are deleted, the system automatically cleans up all references.
Files that are currently being processed by other operations are rejected to prevent conflicts.
Caution:
File deletion is permanent and can't be undone. When you delete a file that's being used in your store,
it will immediately stop appearing wherever it was displayed. For example, if you delete a product image,
that product will show a broken image or placeholder on your storefront and in the admin. The same applies
to any other files linked from themes, blog posts, or pages. Before deleting files, you can use thefilesquery to list and review
your store's file assets.
Learn how to manage
product media and file assets
in your app.
Updates a Metaobject with new field values, handle, or capabilities. Metaobjects are custom data structures that extend Shopify's data model.
You can modify field values mapped to the metaobject's MetaobjectDefinition, update the handle for a unique identifier, and adjust capabilities like publishing status. When updating the handle, you can optionally create a redirect from the old handle to maintain existing references.
Creates or updates a Metaobject based on its handle. If a metaobject with the specified handle exists, the mutation updates it with the provided field values. If no matching metaobject exists, the mutation creates a new one.
The handle serves as a unique identifier within a metaobject type. Field values map to the MetaobjectDefinition's field keys and overwrite existing values during updates.
The partner account that's linked to the shop's enrollment for an agentic channel.
A label declared for an analytics event.
Return type for automationTestEventUpdate mutation.
An error that prevented an automation test event from being updated.
Possible error codes that can be returned by AutomationTestEventUpdateUserError.
Return type for externalAccountSet mutation.
An error that occurs during the execution of ExternalAccountSet.
Possible error codes that can be returned by ExternalAccountSetUserError.
eventLabelsLabels for the events the field lives on, when the app declared one.
validApiClientIdsThe API client IDs of the apps that own the field.
MANAGED_BY_APPlineItemsCREATED_ATcashActivitiesCREATED_ATDIRECTORYBLANKWRITE_RESTRICTED_FILES_REQUIREDINVALID_DIRECTORY_MOVEBATCH_DIRECTORY_MUTATION_NOT_ALLOWEDDIRECTORY_NOT_EMPTYDIRECTORY_ITEM_LIMIT_EXCEEDEDDIRECTORY_NESTED_ITEM_LIMIT_EXCEEDEDDIRECTORY_SHOP_LIMIT_EXCEEDEDRESERVED_DIRECTORY_NAMEUSER_FILE_OUTSIDE_USER_DIRECTORYCREATED_ATcompanyCREATED_ATCREATED_ATcompareDigestThe digest of the metaobject's handle, status, template suffix, and field values. Pass it as compareDigest to metaobjectUpdate or metaobjectUpsert to update the metaobject only if it hasn't changed since it was read.
STALE_OBJECTINVALID_COMPARE_DIGESTexchangeV2sreturnscashActivitiesCREATED_ATCREATED_AT