'returnLineItemRemoveFromReturn' doesn't exist on type 'Mutation'

version 2024-07 of the admin graphql api documents a mutation returnLineItemRemoveFromReturn

https://shopify.dev/docs/api/admin-graphql/2024-07/mutations/returnLineItemRemoveFromReturn

But the API (when using that same verison) responds that the mutation doesn’t exist.

using:

https://xxxx.myshopify.com/admin/api/2024-07/graphql.json

query:

mutation ($returnId: ID!, $returnLineItems: [ReturnLineItemRemoveFromReturnInput!]!) {
      returnLineItemRemoveFromReturn(returnId: $returnId, returnLineItems: $returnLineItems) {
        userErrors {
          field
          message
        }
      }
    }

yields:

"ReturnLineItemRemoveFromReturnInput isn't a defined input type (on $returnLineItems)"(mutation), 
"Field 'returnLineItemRemoveFromReturn' doesn't exist on type 'Mutation'"(mutation:returnLineItemRemoveFromReturn), 
"Variable $returnId is declared by anonymous mutation but not used"(mutation), 
"Variable $returnLineItems is declared by anonymous mutation but not used"(mutation)

Hi Jason,

Could you try this mutation on the GraphiQL App to see if it works there?

Hi @jason_stillwell

You should use this format. Note that the key is to add a name after the mutation, which can be any name

mutation returnLineItemRemoveFromReturn

mutation rlirfr

mutation abc

etc.

mutation returnLineItemRemoveFromReturn($returnId: ID!, $returnLineItems: [ReturnLineItemRemoveFromReturnInput!]!) {
  returnLineItemRemoveFromReturn(returnId: $returnId, returnLineItems: $returnLineItems) {
    return {
      id
    }
    userErrors {
      field
      message
    }
  }
}

Thanks, I figured this out after trying the Shopify Graphql app in my test store.