Finding pending operations on a file

Topic summary

A developer’s Shopify file manager app encounters intermittent FILE_LOCKED errors when attempting to move files via the Shopify API.

The error prevents file operations from completing, but neither merchants nor developers can determine the root cause from available error logs.

Official documentation provides minimal guidance on debugging this specific error code.

Key Questions:

  • Is there a UI or API endpoint to view pending/active operations on a file?
  • Can locked file operations be manually cancelled?

Status: Unresolved. Another developer has reported experiencing the identical issue, but no solution or workaround has been identified yet.

Summarized with AI on October 30. AI used: claude-sonnet-4-5-20250929.

Our app, Craftware Simple File Manager, is running into a bug that prevents the application from moving files.

Shopify file update operations occasionally fail with FILE_LOCKED. Merchants are unable to figure out why and we aren’t able to make out much from the error logs as well. The documentation about the error code is sparse on how to debug such an issue.

Is there a UI / API that lists the pending operations on a file and a way to cancel them?

Did you find out what was the issue? I’m hitting the same problem…