Requires write_files access scope.

Deletes existing file assets that were uploaded to Shopify.


The IDs of the files to be deleted.


Was this section helpful?

The IDs of the deleted files.

The list of errors that occurred from executing the mutation.


Was this section helpful?

Examples

Hide code
DescriptionCopy
mutation fileDelete($input: [ID!]!) {
  fileDelete(fileIds: $input) {
    deletedFileIds
  }
}
curl -X POST \
https://your-development-store.myshopify.com/admin/api/2024-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation fileDelete($input: [ID!]!) { fileDelete(fileIds: $input) { deletedFileIds } }",
 "variables": {
    "input": [
      "gid://shopify/GenericFile/1072273199",
      "gid://shopify/MediaImage/1072273200",
      "gid://shopify/Video/1072273201"
    ]
  }
}'
const { admin } = await authenticate.admin(request);

const response = await admin.graphql(
  `#graphql
  mutation fileDelete($input: [ID!]!) {
    fileDelete(fileIds: $input) {
      deletedFileIds
    }
  }`,
  {
    variables: {
      "input": [
        "gid://shopify/GenericFile/1072273199",
        "gid://shopify/MediaImage/1072273200",
        "gid://shopify/Video/1072273201"
      ]
    },
  },
);

const data = await response.json();
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
  mutation fileDelete($input: [ID!]!) {
    fileDelete(fileIds: $input) {
      deletedFileIds
    }
  }
QUERY

variables = {
  "input": ["gid://shopify/GenericFile/1072273199", "gid://shopify/MediaImage/1072273200", "gid://shopify/Video/1072273201"]
}

response = client.query(query: query, variables: variables)
const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation fileDelete($input: [ID!]!) {
      fileDelete(fileIds: $input) {
        deletedFileIds
      }
    }`,
    "variables": {
      "input": [
        "gid://shopify/GenericFile/1072273199",
        "gid://shopify/MediaImage/1072273200",
        "gid://shopify/Video/1072273201"
      ]
    },
  },
});
use Shopify\Clients\Graphql;

$client = new Graphql("your-development-store.myshopify.com", $accessToken);
$query = <<<QUERY
  mutation fileDelete($input: [ID!]!) {
    fileDelete(fileIds: $input) {
      deletedFileIds
    }
  }
QUERY;

$variables = [
  "input" => ["gid://shopify/GenericFile/1072273199", "gid://shopify/MediaImage/1072273200", "gid://shopify/Video/1072273201"],
];

$response = $client->query(["query" => $query, "variables" => $variables]);
Hide code
Input variables
Copy
{
  "input": [
    "gid://shopify/GenericFile/1072273199",
    "gid://shopify/MediaImage/1072273200",
    "gid://shopify/Video/1072273201"
  ]
}
Hide code
Response
JSON
{
  "fileDelete": {
    "deletedFileIds": [
      "gid://shopify/GenericFile/1072273199",
      "gid://shopify/MediaImage/1072273200",
      "gid://shopify/Video/1072273201"
    ]
  }
}