REST theme API

Topic summary

User reports a failure when uploading a theme via a REST Theme API call from their app. The API returns a validation error stating the ZIP “does not contain a valid theme: missing template ‘layout/theme.liquid’.”

Key detail: The error specifically references the required template path “layout/theme.liquid,” indicating the upload check is failing on that file’s presence/location.

The user asserts the ZIP includes all necessary contents, suggesting a discrepancy between the archive contents and what the API expects.

No fixes, decisions, or outcomes were provided; the thread is currently unresolved.

Central artifact: The error message code snippet is crucial for understanding the issue.

Summarized with AI on February 5. AI used: gpt-5.

I am trying to create a theme through my app and I am having a problem with uploading it.

I keep getting this error even though the theme does have all the contents in it

errors: {
    base: [
      'zip does not contain a valid theme: missing template "layout/theme.liquid"'
    ]
  }