--- title: productOperation - GraphQL Admin description: >- Returns a ProductOperation resource by ID. This can be used to query the [ProductSetOperation](https://shopify.dev/api/admin-graphql/current/objects/ProductSetOperation), using the ID that was returned [when the product was created or updated](https://shopify.dev/api/admin/migrate/new-product-model/sync-data#create-a-product-with-variants-and-options-asynchronously) by the [ProductSet](https://shopify.dev/api/admin-graphql/current/mutations/productSet) mutation. The `status` field indicates whether the operation is `CREATED`, `ACTIVE`, or `COMPLETE`. The `product` field provides the details of the created or updated product. For the [ProductSetOperation](https://shopify.dev/api/admin-graphql/current/objects/ProductSetOperation), the `userErrors` field provides mutation errors that occurred during the operation. api_version: unstable api_name: admin source_url: html: 'https://shopify.dev/docs/api/admin-graphql/unstable/queries/productOperation' md: >- https://shopify.dev/docs/api/admin-graphql/unstable/queries/productOperation.md --- # product​Operation query Returns a ProductOperation resource by ID. This can be used to query the [ProductSetOperation](https://shopify.dev/api/admin-graphql/current/objects/ProductSetOperation), using the ID that was returned [when the product was created or updated](https://shopify.dev/api/admin/migrate/new-product-model/sync-data#create-a-product-with-variants-and-options-asynchronously) by the [ProductSet](https://shopify.dev/api/admin-graphql/current/mutations/productSet) mutation. The `status` field indicates whether the operation is `CREATED`, `ACTIVE`, or `COMPLETE`. The `product` field provides the details of the created or updated product. For the [ProductSetOperation](https://shopify.dev/api/admin-graphql/current/objects/ProductSetOperation), the `userErrors` field provides mutation errors that occurred during the operation. ## Arguments * id [ID!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/ID) required The ID of the `ProductOperation` to return. *** ## Possible returns * Product​Operation [Product​Operation](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/ProductOperation) An entity that represents details of an asynchronous operation on a product. *** ## Examples * ### View the status of an asynchronous product delete operation #### Query ```graphql query ProductDeleteOperation($id: ID!) { productOperation(id: $id) { ... on ProductDeleteOperation { id status deletedProductId product { id } } } } ``` #### Variables ```json { "id": "gid://shopify/ProductDeleteOperation/843567278" } ``` #### cURL ```bash curl -X POST \ https://your-development-store.myshopify.com/admin/api/unstable/graphql.json \ -H 'Content-Type: application/json' \ -H 'X-Shopify-Access-Token: {access_token}' \ -d '{ "query": "query ProductDeleteOperation($id: ID!) { productOperation(id: $id) { ... on ProductDeleteOperation { id status deletedProductId product { id } } } }", "variables": { "id": "gid://shopify/ProductDeleteOperation/843567278" } }' ``` #### React Router ```javascript import { authenticate } from "../shopify.server"; export const loader = async ({request}) => { const { admin } = await authenticate.admin(request); const response = await admin.graphql( `#graphql query ProductDeleteOperation($id: ID!) { productOperation(id: $id) { ... on ProductDeleteOperation { id status deletedProductId product { id } } } }`, { variables: { "id": "gid://shopify/ProductDeleteOperation/843567278" }, }, ); const json = await response.json(); return json.data; } ``` #### Ruby ```ruby session = ShopifyAPI::Auth::Session.new( shop: "your-development-store.myshopify.com", access_token: access_token ) client = ShopifyAPI::Clients::Graphql::Admin.new( session: session ) query = <<~QUERY query ProductDeleteOperation($id: ID!) { productOperation(id: $id) { ... on ProductDeleteOperation { id status deletedProductId product { id } } } } QUERY variables = { "id": "gid://shopify/ProductDeleteOperation/843567278" } response = client.query(query: query, variables: variables) ``` #### Node.js ```javascript const client = new shopify.clients.Graphql({session}); const data = await client.query({ data: { "query": `query ProductDeleteOperation($id: ID!) { productOperation(id: $id) { ... on ProductDeleteOperation { id status deletedProductId product { id } } } }`, "variables": { "id": "gid://shopify/ProductDeleteOperation/843567278" }, }, }); ``` #### Response ```json { "productOperation": { "id": "gid://shopify/ProductDeleteOperation/843567278", "status": "COMPLETE", "deletedProductId": "gid://shopify/Product/20995642", "product": null } } ``` * ### View the status of an asynchronous product duplicate operation #### Query ```graphql query ProductDuplicateOperation($operationId: ID!) { productOperation(id: $operationId) { ... on ProductDuplicateOperation { id status newProduct { id title } userErrors { field message } } } } ``` #### Variables ```json { "operationId": "gid://shopify/ProductDuplicateOperation/893212316" } ``` #### cURL ```bash curl -X POST \ https://your-development-store.myshopify.com/admin/api/unstable/graphql.json \ -H 'Content-Type: application/json' \ -H 'X-Shopify-Access-Token: {access_token}' \ -d '{ "query": "query ProductDuplicateOperation($operationId: ID!) { productOperation(id: $operationId) { ... on ProductDuplicateOperation { id status newProduct { id title } userErrors { field message } } } }", "variables": { "operationId": "gid://shopify/ProductDuplicateOperation/893212316" } }' ``` #### React Router ```javascript import { authenticate } from "../shopify.server"; export const loader = async ({request}) => { const { admin } = await authenticate.admin(request); const response = await admin.graphql( `#graphql query ProductDuplicateOperation($operationId: ID!) { productOperation(id: $operationId) { ... on ProductDuplicateOperation { id status newProduct { id title } userErrors { field message } } } }`, { variables: { "operationId": "gid://shopify/ProductDuplicateOperation/893212316" }, }, ); const json = await response.json(); return json.data; } ``` #### Ruby ```ruby session = ShopifyAPI::Auth::Session.new( shop: "your-development-store.myshopify.com", access_token: access_token ) client = ShopifyAPI::Clients::Graphql::Admin.new( session: session ) query = <<~QUERY query ProductDuplicateOperation($operationId: ID!) { productOperation(id: $operationId) { ... on ProductDuplicateOperation { id status newProduct { id title } userErrors { field message } } } } QUERY variables = { "operationId": "gid://shopify/ProductDuplicateOperation/893212316" } response = client.query(query: query, variables: variables) ``` #### Node.js ```javascript const client = new shopify.clients.Graphql({session}); const data = await client.query({ data: { "query": `query ProductDuplicateOperation($operationId: ID!) { productOperation(id: $operationId) { ... on ProductDuplicateOperation { id status newProduct { id title } userErrors { field message } } } }`, "variables": { "operationId": "gid://shopify/ProductDuplicateOperation/893212316" }, }, }); ``` #### Response ```json { "productOperation": { "id": "gid://shopify/ProductDuplicateOperation/893212316", "status": "COMPLETE", "newProduct": { "id": "gid://shopify/Product/108828309", "title": "Draft (Copy)" }, "userErrors": [] } } ``` * ### View the status of an asynchronous product set operation #### Query ```graphql query productSetOperation($id: ID!) { productOperation(id: $id) { ... on ProductSetOperation { id status product { id } userErrors { field message code } } } } ``` #### Variables ```json { "id": "gid://shopify/ProductSetOperation/824846712" } ``` #### cURL ```bash curl -X POST \ https://your-development-store.myshopify.com/admin/api/unstable/graphql.json \ -H 'Content-Type: application/json' \ -H 'X-Shopify-Access-Token: {access_token}' \ -d '{ "query": "query productSetOperation($id: ID!) { productOperation(id: $id) { ... on ProductSetOperation { id status product { id } userErrors { field message code } } } }", "variables": { "id": "gid://shopify/ProductSetOperation/824846712" } }' ``` #### React Router ```javascript import { authenticate } from "../shopify.server"; export const loader = async ({request}) => { const { admin } = await authenticate.admin(request); const response = await admin.graphql( `#graphql query productSetOperation($id: ID!) { productOperation(id: $id) { ... on ProductSetOperation { id status product { id } userErrors { field message code } } } }`, { variables: { "id": "gid://shopify/ProductSetOperation/824846712" }, }, ); const json = await response.json(); return json.data; } ``` #### Ruby ```ruby session = ShopifyAPI::Auth::Session.new( shop: "your-development-store.myshopify.com", access_token: access_token ) client = ShopifyAPI::Clients::Graphql::Admin.new( session: session ) query = <<~QUERY query productSetOperation($id: ID!) { productOperation(id: $id) { ... on ProductSetOperation { id status product { id } userErrors { field message code } } } } QUERY variables = { "id": "gid://shopify/ProductSetOperation/824846712" } response = client.query(query: query, variables: variables) ``` #### Node.js ```javascript const client = new shopify.clients.Graphql({session}); const data = await client.query({ data: { "query": `query productSetOperation($id: ID!) { productOperation(id: $id) { ... on ProductSetOperation { id status product { id } userErrors { field message code } } } }`, "variables": { "id": "gid://shopify/ProductSetOperation/824846712" }, }, }); ``` #### Response ```json { "productOperation": { "id": "gid://shopify/ProductSetOperation/824846712", "status": "COMPLETE", "product": { "id": "gid://shopify/Product/20995642" }, "userErrors": [] } } ``` [Open in GraphiQL](http://localhost:3457/graphiql?query=query%20ProductDeleteOperation\(%24id%3A%20ID!\)%20%7B%0A%20%20productOperation\(id%3A%20%24id\)%20%7B%0A%20%20%20%20...%20on%20ProductDeleteOperation%20%7B%0A%20%20%20%20%20%20id%0A%20%20%20%20%20%20status%0A%20%20%20%20%20%20deletedProductId%0A%20%20%20%20%20%20product%20%7B%0A%20%20%20%20%20%20%20%20id%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D\&variables=%7B%0A%20%20%22id%22%3A%20%22gid%3A%2F%2Fshopify%2FProductDeleteOperation%2F843567278%22%0A%7D) ```javascript import { authenticate } from "../shopify.server"; export const loader = async ({request}) => { const { admin } = await authenticate.admin(request); const response = await admin.graphql( `#graphql query ProductDeleteOperation($id: ID!) { productOperation(id: $id) { ... on ProductDeleteOperation { id status deletedProductId product { id } } } }`, { variables: { "id": "gid://shopify/ProductDeleteOperation/843567278" }, }, ); const json = await response.json(); return json.data; } ``` ##### GQL ``` query ProductDeleteOperation($id: ID!) { productOperation(id: $id) { ... on ProductDeleteOperation { id status deletedProductId product { id } } } } ``` ##### cURL ``` curl -X POST \ https://your-development-store.myshopify.com/admin/api/unstable/graphql.json \ -H 'Content-Type: application/json' \ -H 'X-Shopify-Access-Token: {access_token}' \ -d '{ "query": "query ProductDeleteOperation($id: ID!) { productOperation(id: $id) { ... on ProductDeleteOperation { id status deletedProductId product { id } } } }", "variables": { "id": "gid://shopify/ProductDeleteOperation/843567278" } }' ``` ##### React Router ``` import { authenticate } from "../shopify.server"; export const loader = async ({request}) => { const { admin } = await authenticate.admin(request); const response = await admin.graphql( `#graphql query ProductDeleteOperation($id: ID!) { productOperation(id: $id) { ... on ProductDeleteOperation { id status deletedProductId product { id } } } }`, { variables: { "id": "gid://shopify/ProductDeleteOperation/843567278" }, }, ); const json = await response.json(); return json.data; } ``` ##### Node.js ``` const client = new shopify.clients.Graphql({session}); const data = await client.query({ data: { "query": `query ProductDeleteOperation($id: ID!) { productOperation(id: $id) { ... on ProductDeleteOperation { id status deletedProductId product { id } } } }`, "variables": { "id": "gid://shopify/ProductDeleteOperation/843567278" }, }, }); ``` ##### Ruby ``` session = ShopifyAPI::Auth::Session.new( shop: "your-development-store.myshopify.com", access_token: access_token ) client = ShopifyAPI::Clients::Graphql::Admin.new( session: session ) query = <<~QUERY query ProductDeleteOperation($id: ID!) { productOperation(id: $id) { ... on ProductDeleteOperation { id status deletedProductId product { id } } } } QUERY variables = { "id": "gid://shopify/ProductDeleteOperation/843567278" } response = client.query(query: query, variables: variables) ``` ## Input variables JSON ```json { "id": "gid://shopify/ProductDeleteOperation/843567278" } ``` ## Response JSON ```json { "productOperation": { "id": "gid://shopify/ProductDeleteOperation/843567278", "status": "COMPLETE", "deletedProductId": "gid://shopify/Product/20995642", "product": null } } ```