apiAssignProductMedia

MutationKey required

Shop API: attaches an image to one variant of an owned product, or back to the shared gallery when variantId is null (docs/adr/0110). Requires the catalog.media or offers.manage scope.

Arguments

Name	Type	Description
assetId	`String!`	required
productId	`String!`	required
variantId	`String`

Returns

Product!

Example

GraphQL

mutation ApiAssignProductMedia($assetId: String!, $productId: String!, $variantId: String) {
  apiAssignProductMedia(assetId: $assetId, productId: $productId, variantId: $variantId) {
    attributesJson
    brandId
    categoryId
    countryOfOrigin
    description {
      ar
      en
      fr
      tn
    }
    familyId
    fieldSetValuesJson
    flags {
      adult
      ageMin
      battery
      hazardous
      retailBoxed
      shipsAsIs
      thisSideUp
    }
    gtin
    hsCode
    id
    kind
    manufacturer
    media {
      assetId
      position
      role
      variantId
      variantSku
    }
    mediaAssetIds
    mpn
    ownerOrganizationId
    prepSteps
    publishedAt
    quality {
      missing
      score
    }
    secondaryCategoryIds
    seo { __typename }
    slug {
      ar
      en
      fr
      tn
    }
    status
    title {
      ar
      en
      fr
      tn
    }
    updatedAt
    variants {
      axisValuesJson
      fragile
      gtin
      heightMm
      id
      lengthMm
      liquid
      measuredAt
      measuredHeightMm
      measuredLengthMm
      measuredWeightGrams
      measuredWidthMm
      mpn
      packageQuantity
      position
      sharp
      sku
      weightGrams
      widthMm
    }
    warrantyMonths
  }
}

curl

curl -sS https://api.wamia.tn/connect/graphql \
  -H 'content-type: application/json' \
  -H 'x-api-key: wamia_…' \
  -H 'user-agent: my-integration/1.0.0 (+https://shop.example.tn)' \
  -H 'wamia-idempotency-key: 6f0e1a2b-…' \
  --data '{"query":"mutation ApiAssignProductMedia($assetId: String!, $productId: String!, $variantId: String) { apiAssignProductMedia(assetId: $assetId, productId: $productId, variantId: $variantId) { attributesJson brandId categoryId countryOfOrigin description { ar en fr tn } familyId fieldSetValuesJson flags { adult ageMin battery hazardous retailBoxed shipsAsIs thisSideUp } gtin hsCode id kind manufacturer media { assetId position role variantId variantSku } mediaAssetIds mpn ownerOrganizationId prepSteps publishedAt quality { missing score } secondaryCategoryIds seo { __typename } slug { ar en fr tn } status title { ar en fr tn } updatedAt variants { axisValuesJson fragile gtin heightMm id lengthMm liquid measuredAt measuredHeightMm measuredLengthMm measuredWeightGrams measuredWidthMm mpn packageQuantity position sharp sku weightGrams widthMm } warrantyMonths } }"}'