The access scope "write_themes_assets" is not valid

[bashrj]

Summary

Using the Shopify CLI app with the version information down below
@shopify/cli/3.68.1 linux-x64 node-v22.6.0

I am UNABLE to deploy my app (REMIX JS) when including the write_themes_assets access scope in shopify.app.toml

According to the docs for the themeFilesUpsert mutation, I am REQUIRED to include this access scope.

Shopify's GRAPHIQL App (with all permissions granted for a dev store) seems not to have this issue and runs the mutation successfully despite only having read_themes & write_themes permissions available for selection on the install page

Steps to reproduce the problem

1. shopify app init # choosing the Remix start with vanilla Javascript
2. <include the access scope write_themes_assets in shopify.app.toml>
3. shopify app deploy

Debug logs

╭─ error ───────────────────────────────────────────────────────────────────────────────────────────────╮
│                                                                                                       │
│  Version couldn't be created.                                                                         │
│                                                                                                       │
│  app-access                                                                                           │
│                                                                                                       │
│  Validation errors                                                                                    │
│    • scopes: These scopes are invalid - [write_themes_assets]                                         │
│                                                                                                       │
╰───────────────────────────────────────────────────────────────────────────────────────────────────────╯

[lizkenyon]

Hi there 👋

This doesn't seem like an issue with the Remix app template, or javascript libraries.

I believe for the write_theme_assets scope you need to request permission like described here.

I have flagged with the Themes team the documentation should be clarified.

In the future questions not about the Remix app template and javascript libraries can be asked in the Community Forums.