Update a product media record

Update a product media record.

Required permissions: PRODUCT

put

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

Authorizations

AuthorizationstringRequired

Access token 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

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

mainUrlstringRequired

thumbnailUrlstringRequired

positionintegerRequired

widthintegerRequired

heightintegerRequired

isCoverImagebooleanRequired

sourcestring · enumRequiredPossible values:

createdAtstring · date-timeRequired

createdBystringRequired

lastModifiedAtstring · date-timeRequired

lastModifiedBystringRequired

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-01T00:00:00.000Z",
  "createdBy": "text",
  "lastModifiedAt": "2026-01-01T00:00:00.000Z",
  "lastModifiedBy": "text"
}