shopify_create_file
DestructiveIdempotent
Create Shopify files from public or staged URLs to use real imagery in theme templates and pages. Upload up to 50 files per call for images, videos, 3D models, and more.
Instructions
Create shop files (images/media) from public URLs or staged resource urls, so real imagery can be referenced from theme templates and pages. Pass a single file inline, or a files list for up to 50 per call.
Args:
original_source: Public URL or staged resource_url for a single file. Required unless files is given.
content_type: Shopify file content type: IMAGE (default), FILE, VIDEO, EXTERNAL_VIDEO, MODEL_3D.
alt: Alt text for the single-file form.
filename: Filename override for the single-file form.
files: JSON-string list of files (max 50): [{original_source, content_type?, alt?, filename?}]. Replaces the single-file fields when provided.
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 |
|---|---|---|---|
| alt | No | ||
| files | No | ||
| effect | No | ||
| filename | No | ||
| project_id | No | ||
| project_ref | No | ||
| approval_ref | No | ||
| content_type | No | IMAGE | |
| idempotency_key | No | ||
| original_source | No | ||
| connector_account_ref | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |