shopify_upsert_theme_files
DestructiveIdempotent
Create or update up to 50 Shopify development theme files in a single call, verifying file digests and preventing changes to main themes.
Instructions
Create or update up to 50 files on a DEVELOPMENT theme in one call. UNPUBLISHED release candidates and MAIN themes are immutable and refused with SHOPIFY_THEME_ROLE_PROTECTED. The connector waits for the bounded Shopify job and independently compares exact filename/body representation digests.
Args:
theme_id (required): DEVELOPMENT theme ID (numeric or GID).
files (required): JSON-string list of files (max 50): [{filename, content?, url?, base64?}]. Use content for text bodies (Liquid/JSON/CSS); url or base64 for binary assets.
expected_preimage_sha256 (required): Exact governed get_theme lifecycle digest approved for this file mutation.
project_id: Authenticated Project UUID.
project_ref: Exact project correlation reference.
connector_account_ref: Project-bound connector account alias.
idempotency_key: Stable business-action identity.
effect: Claimed read or write effect; Spring verifies it.
approval_ref: Approved platform task UUID when resuming a write.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| files | No | ||
| effect | No | ||
| theme_id | No | ||
| project_id | No | ||
| project_ref | No | ||
| approval_ref | No | ||
| idempotency_key | No | ||
| connector_account_ref | No | ||
| expected_preimage_sha256 | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |