ProductMedia

List product media

get

/tenants/{tenantUid}/products/{productUid}/media

List media (images, videos) for a given product.

Authorizations

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

productUidstringRequired

Reference to a Product.

Pattern: ^[A-Za-z0-9-_]+

Query parameters

pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

Responses

200

Example response

application/json

get

/tenants/{tenantUid}/products/{productUid}/media

GET /v2/tenants/{tenantUid}/products/{productUid}/media HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Example response

{
  "items": [
    {
      "productMediaUid": "text",
      "mainUrl": "text",
      "thumbnailUrl": "text",
      "position": 1,
      "width": 1,
      "height": 1,
      "isCoverImage": true,
      "source": "FLOW",
      "createdAt": "2026-01-29T12:40:16.957Z",
      "createdBy": "text",
      "lastModifiedAt": "2026-01-29T12:40:16.957Z",
      "lastModifiedBy": "text"
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Create new product media

post

/tenants/{tenantUid}/products/{productUid}/media

When you already have the images that you want to use, add them as the URL. Note that the URLs must be publicly accessible.

Authorizations

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

productUidstringRequired

Reference to a Product.

Pattern: ^[A-Za-z0-9-_]+

Body

mainUrlstringRequired

thumbnailUrlstringOptional

positionintegerOptional

setAsCoverImagebooleanOptional

productMediaUidstringOptionalPattern: ^[A-Za-z0-9-_]*

Responses

201

Example response

application/json

post

/tenants/{tenantUid}/products/{productUid}/media

POST /v2/tenants/{tenantUid}/products/{productUid}/media HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 101

{
  "mainUrl": "text",
  "thumbnailUrl": "text",
  "position": 1,
  "setAsCoverImage": true,
  "productMediaUid": "text"
}

201

Example response

{
  "productMediaUid": "text",
  "mainUrl": "text",
  "thumbnailUrl": "text",
  "position": 1,
  "width": 1,
  "height": 1,
  "isCoverImage": true,
  "source": "FLOW",
  "createdAt": "2026-01-29T12:40:16.957Z",
  "createdBy": "text",
  "lastModifiedAt": "2026-01-29T12:40:16.957Z",
  "lastModifiedBy": "text"
}

Get a product media record

get

/tenants/{tenantUid}/products/{productUid}/media/{productMediaUid}

Retrieve the data record for the given product media.

Authorizations

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

productUidstringRequired

Reference to a Product.

Pattern: ^[A-Za-z0-9-_]+

productMediaUidstringRequired

Reference to a product media record.

Responses

200

Example response

application/json

get

/tenants/{tenantUid}/products/{productUid}/media/{productMediaUid}

GET /v2/tenants/{tenantUid}/products/{productUid}/media/{productMediaUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Example response

{
  "productMediaUid": "text",
  "mainUrl": "text",
  "thumbnailUrl": "text",
  "position": 1,
  "width": 1,
  "height": 1,
  "isCoverImage": true,
  "source": "FLOW",
  "createdAt": "2026-01-29T12:40:16.957Z",
  "createdBy": "text",
  "lastModifiedAt": "2026-01-29T12:40:16.957Z",
  "lastModifiedBy": "text"
}

Update a product media record

put

/tenants/{tenantUid}/products/{productUid}/media/{productMediaUid}

Update a product media record.

Authorizations

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

productUidstringRequired

Reference to a Product.

Pattern: ^[A-Za-z0-9-_]+

productMediaUidstringRequired

Reference to a product media record.

Body

mainUrlstringOptional

thumbnailUrlstringOptional

positionintegerOptional

setAsCoverImagebooleanOptional

Responses

200

Example response

application/json

put

/tenants/{tenantUid}/products/{productUid}/media/{productMediaUid}

PUT /v2/tenants/{tenantUid}/products/{productUid}/media/{productMediaUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 76

{
  "mainUrl": "text",
  "thumbnailUrl": "text",
  "position": 1,
  "setAsCoverImage": true
}

200

Example response

{
  "productMediaUid": "text",
  "mainUrl": "text",
  "thumbnailUrl": "text",
  "position": 1,
  "width": 1,
  "height": 1,
  "isCoverImage": true,
  "source": "FLOW",
  "createdAt": "2026-01-29T12:40:16.957Z",
  "createdBy": "text",
  "lastModifiedAt": "2026-01-29T12:40:16.957Z",
  "lastModifiedBy": "text"
}

Delete a product media record.

delete

/tenants/{tenantUid}/products/{productUid}/media/{productMediaUid}

Delete a product media record.

Authorizations

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

productUidstringRequired

Reference to a Product.

Pattern: ^[A-Za-z0-9-_]+

productMediaUidstringRequired

Reference to a product media record.

Responses

204

No Content

delete

/tenants/{tenantUid}/products/{productUid}/media/{productMediaUid}

DELETE /v2/tenants/{tenantUid}/products/{productUid}/media/{productMediaUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

204

No Content

No content

Upload product media

post

/tenants/{tenantUid}/products/{productUid}/media/upload

Upload a new image or video. We accept two kinds of values in the file field, either base64 a Base64 encoded string of the file content, or URL a URL of the file from where to download the content (make sure that the URL is accessible).

Filename is the name with which the file will be uploaded, e.g. "new-image.jpg".

Authorizations

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

productUidstringRequired

Reference to a Product.

Pattern: ^[A-Za-z0-9-_]+

Body

mediastringRequired

The file content as base64 or source URL.

filenamestringRequired

positionintegerOptional

productMediaUidstringOptionalPattern: ^[A-Za-z0-9-_]+

setAsCoverImagebooleanOptional

Responses

201

Example response

application/json

post

/tenants/{tenantUid}/products/{productUid}/media/upload

POST /v2/tenants/{tenantUid}/products/{productUid}/media/upload HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 95

{
  "media": "text",
  "filename": "text",
  "position": 1,
  "productMediaUid": "text",
  "setAsCoverImage": true
}

201

Example response

{
  "productMediaUid": "text",
  "mainUrl": "text",
  "thumbnailUrl": "text",
  "position": 1,
  "width": 1,
  "height": 1,
  "isCoverImage": true,
  "source": "FLOW",
  "createdAt": "2026-01-29T12:40:16.957Z",
  "createdBy": "text",
  "lastModifiedAt": "2026-01-29T12:40:16.957Z",
  "lastModifiedBy": "text"
}

Set all media for a product

post

/tenants/{tenantUid}/products/{productUid}/media/batch

Set all the media items for a product in one go. The payload is an array refelecting all the media on the given product. In addition to adding the new entries, this will also remove any exising entries that are not in the payload. So an empty array will delete all the product media on the product.

If no media is set as cover image, the first media added will be used. Only one image can be set as the cover image.

Authorizations

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

productUidstringRequired

Reference to a Product.

Pattern: ^[A-Za-z0-9-_]+

Body

Responses

204

No Content

post

/tenants/{tenantUid}/products/{productUid}/media/batch

POST /v2/tenants/{tenantUid}/products/{productUid}/media/batch HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 113

{
  "items": [
    {
      "mainUrl": "text",
      "thumbnailUrl": "text",
      "position": 1,
      "setAsCoverImage": true,
      "productMediaUid": "text"
    }
  ]
}

204

No Content

No content

PreviousProductGroup NextProductPackage

Last updated 9 months ago

Was this helpful?

hashtagList product media

hashtagCreate new product media

hashtagGet a product media record

hashtagUpdate a product media record

hashtagDelete a product media record.

hashtagUpload product media

hashtagSet all media for a product

List product media

Create new product media

Get a product media record

Update a product media record

Delete a product media record.

Upload product media

Set all media for a product