How to Retrieve Evidence and File IDs for disputeEvidenceUpdate Mutation

GraphQL Admin API Troubleshooting
1

I’m trying to use the disputeEvidenceUpdate GraphQL mutation to submit evidence to a dispute, as shown in this example:
:link: disputeEvidenceUpdate - GraphQL Admin

However, I’m unclear on how to retrieve the required IDs:

  1. evidence.id – The ID of the dispute evidence to be updated
    I reviewed the dispute data via GraphQL (shopifyPaymentsDispute), but I don’t see any field that returns the evidence ID.
  2. uncategorizedFile.id – The ID of the file uploaded to the dispute
    How and where do I retrieve this after uploading the file?

Could you please clarify how to obtain both of these IDs using the Admin GraphQL API?

Thank you!

1 Like
3

Thanks for reporting this @Itay_Kirshenboim, I’m looking in to this and will report back here with what I find.

1 Like
4

is there any update?

5

I don’t have an update yet but will let you know when I do.

6

Hey! We’ve taken a look here and I can confirm that there is currently a gap blocking querying these field to get the ID’s you need.

We are working at filling that in. In the meantime, the REST API’s can still be used for this Dispute Evidence - REST

8

Hey @Itay_Kirshenboim, we were able to add these fields. You’ll be able to retrieve them starting with 2025-10 ShopifyPaymentsDispute - GraphQL Admin

1 Like
9

However, I’m unclear on how to retrieve the required IDs:

  1. evidence.id – The ID of the dispute evidence to be updated
    I reviewed the dispute data via GraphQL (shopifyPaymentsDispute), but I don’t see any field that returns the evidence ID.
  2. uncategorizedFile.id – The ID of the file uploaded to the dispute
    How and where do I retrieve this after uploading the file?

Could you please clarify how to obtain both of these IDs using the Admin GraphQL API?

10

could you please show me an example of the graphql query

11

Happy to help. Make sure you’re using API version 2025-10. The query will look something like this:

{
    disputes(first: 10) {
        nodes {
            disputeEvidence {
                id
                uncategorizedFile {
                    id
                    url
                }
            }
        }
    }
}
12

Should I attach the new fileId returned by the fileCreate mutation, or use the existing uncategorizedFileId from the dispute?

14

Hey! Sorry I missed this follow up! The GID (Global ID) of the file should be able to be used in the disputeUpdate mutation to associate the file with a dispute.

If you run in to issues with that though, let me know!