Skip to main content
PUT
/
api
/
v1
/
:team_slug
/
:app_slug
/
images
Error
A valid request URL is required to generate request examples
{
  "data": {
    "alt": "<string>",
    "app_id": "<string>",
    "attributes": [
      {
        "created_at": "<string>",
        "description": "<string>",
        "filterable": true,
        "id": "<string>",
        "key": "<string>",
        "name": "<string>",
        "template_key": "<string>",
        "template_name": "<string>",
        "translatable": true,
        "translations": {
          "description": [
            {
              "id": "<string>",
              "locale": "<string>",
              "omni_channel_translations": [
                {
                  "id": "<string>",
                  "market_id": "<string>",
                  "store_group_id": "<string>",
                  "value": "<string>"
                }
              ],
              "value": "<string>"
            }
          ],
          "name": [
            {
              "id": "<string>",
              "locale": "<string>",
              "omni_channel_translations": [
                {
                  "id": "<string>",
                  "market_id": "<string>",
                  "store_group_id": "<string>",
                  "value": "<string>"
                }
              ],
              "value": "<string>"
            }
          ]
        },
        "updated_at": "<string>",
        "values": {}
      }
    ],
    "blurhash": "<string>",
    "copyright": "<string>",
    "custom": {},
    "folder_id": "<string>",
    "id": "<string>",
    "status": "<string>",
    "title": "<string>",
    "translations": {
      "alt": [
        {
          "id": "<string>",
          "locale": "<string>",
          "omni_channel_translations": [
            {
              "id": "<string>",
              "market_id": "<string>",
              "store_group_id": "<string>",
              "value": "<string>"
            }
          ],
          "value": "<string>"
        }
      ],
      "copyright": [
        {
          "id": "<string>",
          "locale": "<string>",
          "omni_channel_translations": [
            {
              "id": "<string>",
              "market_id": "<string>",
              "store_group_id": "<string>",
              "value": "<string>"
            }
          ],
          "value": "<string>"
        }
      ],
      "title": [
        {
          "id": "<string>",
          "locale": "<string>",
          "omni_channel_translations": [
            {
              "id": "<string>",
              "market_id": "<string>",
              "store_group_id": "<string>",
              "value": "<string>"
            }
          ],
          "value": "<string>"
        }
      ]
    },
    "url": "<string>",
    "used_by": [
      {
        "created_at": "<string>",
        "id": "<string>",
        "name": "<string>",
        "priority": 123,
        "slug": "<string>",
        "type": "product",
        "updated_at": "<string>"
      }
    ]
  },
  "details": [
    "<string>"
  ],
  "success": true
}

Path Parameters

​
app_slug
string
required

App slug

​
team_slug
string
required

Team slug

Query Parameters

​
connect_to_sku
boolean

Try to connect the image to a product or variant using the filename. If filename matches an existing product or variant do we connect it. We do also allow decide priority when connect_to_sku is true. The format for the filenames is sku_priority.extension and if the format don't match sku_priority(e.g sku.jpeg) do we fallback to priority 10

​
connect_to_slug
boolean

Try to connect the image to a product usign the filename. If filename matches an existing product do we connect it. We do also allow decide priority when connect_to_sku is true. The format for the filenames is slug_priority.extension and if the format don't match slug_priority(e.g slug.jpeg) do we fallback to priority 10

Body

application/x-www-form-urlencoded
​
title
string

Image title

​
alt
string

Alternative image text

​
copyright
string

Image copyright text

​
image
file

Image file to upload

​
url
string

Url to source file. Url will be used if provided over file

​
status
string

Status for image. One of active, inactive, draft

Response

Image uploaded successfully

​
data
object
​
details
string[]

Other information which can be relative to the response. This field is used to give additional information then the main data we want to return. For instance if a product do not match the publishing rules will the product status be set to Incomplete and this field will include why

​
success
boolean