Mutation
Anchor to FieldsFields
- fetchCustomDataTokenForUser (FetchCustomDataTokenForUserPayload)
- fetchTokensForUser (FetchTokensForUserPayload)
- mediaCreate (MediaCreatePayload)
- mediaDelete (MediaDeletePayload)
- mediaUpdate (MediaUpdatePayload)
- metafieldAccessGrant (MetafieldAccessGrantPayload)
- metafieldAccessRevoke (MetafieldAccessRevokePayload)
- metafieldDefinitionCreate (MetafieldDefinitionCreatePayload)
- metafieldDefinitionDelete (MetafieldDefinitionDeletePayload)
- metafieldDefinitionUpdate (MetafieldDefinitionUpdatePayload)
- metafieldNamespaceCreate (MetafieldNamespaceCreatePayload)
- metafieldNamespaceDelete (MetafieldNamespaceDeletePayload)
- metafieldNamespaceUpdate (MetafieldNamespaceUpdatePayload)
- standardMetafieldDefinitionEnable (StandardMetafieldDefinitionEnablePayload)
- Anchor to fetchCustomDataTokenForUserfetch•Fetch
Custom Data Token For User Custom Data Token For User Payload Fetch an OAuth Access and Refresh Token pair for the Shop Users API to read or write metafields after user's presence interaction ends.
If a user has used Sign in with Shop with your App client, you may retreive tokens to read / write your own metafields on a user.
- Anchor to emailemail•String!required
The email of the buyer for whom you need an Access token.
- Anchor to throughthrough•String
Private to Shopify Internal clients. Allows a storefront to be passed in by its myshopify domain.
Arguments
- Anchor to fetchTokensForUserfetch•Fetch
Tokens For User Tokens For User Payload Fetch an OAuth Access and Refresh Token pair for a user. Exactly one of
ormust be provided.When
is provided, the user's existing connection with the client is verified and tokens are issued for the consented scope.When
is provided — a signed JWT from a Sign in with Shop flow granting delegated consent from a merchant's buyer connection to this partner — the token is verified, a delegated user connection is established, and tokens are issued for the delegated scope.- Anchor to consentTokenconsent•String
Token Signed JWT consent token from a Sign in with Shop flow granting delegated access. Required when not providing a public ID.
- Anchor to publicIdpublic•String
Id The public ID of the user. Required when not providing a consent token.
Arguments
- Anchor to mediaCreatemedia•Media
Create Create Payload Create a new shop video with related products.
- Anchor to inputinput•Media
Create Input! required
Arguments
- Anchor to mediaDeletemedia•Media
Delete Delete Payload Delete a shop video (soft delete).
- •ID!required
The video ID in GID format (e.g., gid://shopapp/ShopVideo/ea9088eb-9a19-45b8-9d2c-5ca2b8ae13d1).
Arguments
- •ID!
- Anchor to mediaUpdatemedia•Media
Update Update Payload Update an existing shop video.
- Anchor to inputinput•Media
Update Input! required
Arguments
- Anchor to metafieldAccessGrantmetafield•Metafield
Access Grant Access Grant Payload Share a Metafield Primitive with a Client or Namespace. Requires the 'share_metafield' client scope and requires that the Client making the request has Admin permission on the Resource.
- Anchor to accessaccess•Custom
Data Access Input! required Update the default permission of the resource and/or provide a list of targets to give access to the resource.
- Anchor to identifieridentifier•Custom
Data Key Pair Input! required Key and namespace pair that together form the path to the resource. Key is required, Namespace defaults to the Client's implicit, reserved namespace if not provided.
- •String
Use 'key' to provide a new key for the target when sharing, if desired. Only changes the key for the newly shared resource within the grantee's reserved namespace, not the grantor's.
Arguments
- Anchor to metafieldAccessRevokemetafield•Metafield
Access Revoke Access Revoke Payload Revoke shared access between a Metafield Primitive and a Client or Namespace for Primitives of which your Client is an Admin.
- Anchor to identifieridentifier•Custom
Data Key Pair Input! required Key and namespace pair that together form the path to the resource. Key is required, Namespace defaults to the Client's implicit, reserved namespace if not provided.
- Anchor to targetstargets•[Target
Input!]! required A list of targets for whom to revoke access from the given resource.
Arguments
- Anchor to metafieldDefinitionCreatemetafield•Metafield
Definition Create Definition Create Payload Create a new MetafieldDefinition.
- Anchor to definitiondefinition•Metafield
Definition Create Input! required
Arguments
- Anchor to metafieldDefinitionDeletemetafield•Metafield
Definition Delete Definition Delete Payload Remove a MetafieldDefinition and cascade delete all associated Metafields.
- Anchor to identifieridentifier•Custom
Data Key Pair Input! required This argument accepts an object that consists of a
keyand an optionalnamespace. Thekeyis a mandatory attribute that represents a specific element within a namespace. Thenamespaceattribute, if provided, should be a period-delimited string representing the hierarchical path to the desired definition. This is applicable in cases where the desired definition is nested within namespaces. In the absence of a providednamespace, the system will default to the client's implicit, reserved namespace.
Arguments
- Anchor to metafieldDefinitionUpdatemetafield•Metafield
Definition Update Definition Update Payload Update a MetafieldDefinition by changing its key, name, description, capabilities, or access.
- Anchor to definitiondefinition•Metafield
Definition Update Input! required
Arguments
- Anchor to metafieldNamespaceCreatemetafield•Metafield
Namespace Create Namespace Create Payload Create a new MetafieldNamespace.
Every client has their own implicit, reserved namespace; however, Namespaces allow sharing groups of Metafield Primitives and Access Grants together. Creating new Namespaces requires the client to have additional scope and is not available to all clients.
- Anchor to namespacenamespace•Metafield
Namespace Create Input! required
Arguments
- Anchor to metafieldNamespaceDeletemetafield•Metafield
Namespace Delete Namespace Delete Payload Destroy a Namespace and remove any shared Access. MetafieldDefinitions shared to the Namespace will not be deleted, but their association with the namespace will be removed.
- Anchor to identifieridentifier•Custom
Data Key Pair Input! required This argument accepts an object that consists of a
keyand an optionalnamespace. Thekeyis a mandatory attribute that represents a specific element within a namespace. Thenamespaceattribute, if provided, should be a period-delimited string representing the hierarchical path to the desired namespace. This is applicable in cases where the desired namespace is nested within other namespaces. In the absence of a providednamespace, the system will default to the client's implicit, reserved namespace.
Arguments
- Anchor to metafieldNamespaceUpdatemetafield•Metafield
Namespace Update Namespace Update Payload Update a MetafieldNamespace by changing its key, name, description, capabilities, or access.
- Anchor to namespacenamespace•Metafield
Namespace Update Input! required
Arguments
- Anchor to standardMetafieldDefinitionEnablestandard•Standard
Metafield Definition Enable Metafield Definition Enable Payload TK - Not implemented.
- •String!required
- Anchor to namespacenamespace•String!required
Arguments
- •String!