---
title: "/2026-01/retail-media/accounts/{account-id}/creatives/{creative-id}"
method: PUT
path: "/2026-01/retail-media/accounts/{account-id}/creatives/{creative-id}"
tags: ["Campaign"]
---

# /2026-01/retail-media/accounts/{account-id}/creatives/{creative-id}

`PUT /2026-01/retail-media/accounts/{account-id}/creatives/{creative-id}`

## Request

- Base URL: `https://api.criteo.com`
- URL: `https://api.criteo.com/2026-01/retail-media/accounts/{account-id}/creatives/{creative-id}`
- Auth: OAuth 2
  - Authorization code: `https://api.criteo.com/oauth2`
  - Client credentials
  - Token URL: `https://api.criteo.com/oauth2/token` scopes: `RetailMedia_Campaign_Manage`

Update a creative

## Path parameters

- `account-id` string, required
- `creative-id` string, required

## Request body

- CreativeUpdateModel202207: Update model of a creative
  - `brandId` integer: The brand associated to the creative
  - `id` string, nullable
  - `name` string, required: The name of the creative
  - `retailerId` integer, required: The retailer associated to the creative
  - `templateId` integer, required: The creative template used for this creative
  - `templateVariableValues` TemplateVariableValue[], required: The template chosen values
    - `choiceVariableValue` ChoiceVariableValue, nullable: A value of a template choice variable (among different accepted options)
      - `chosenOptions` string[], required: The chosen options
    - `colorVariableValue` ColorVariableValue, nullable: A value of a template color variable
      - `color` string, nullable, required: The displayed color (HEX format)
    - `filesVariableValue` FilesVariableValue, nullable: A value of a template file variable (one or several files), like images in a creative
      - `assetIds` string[], required: The assets representing the images to be displayed
    - `hyperlinkVariableValue` HyperlinkVariableValue, nullable: A value of a template hyperlink variable
      - `url` string, nullable, required: The url to redirect to
    - `id` string, required: The id of the template variable the value is applied to
    - `textVariableValue` TextVariableValue, nullable: A value of a template text variable
      - `text` string, nullable, required: The displayed text
    - `videoVariableValue` VideoVariableValue, nullable: A value of a template video variable
      - `duration` string, required: The video's duration
      - `height` integer, required: The video's height
      - `url` string, required: The vast video url
      - `width` integer, required: The video's width

## Response `201`

Creative updated

- Creative202210Response: A top-level object that encapsulates a Criteo API response for a single entity.
  - `data` ResourceOfCreative202210, nullable: A class that represents a domain entity exposed by an API.
    - `attributes` Creative202210, nullable: A creative entity
      - `associatedLineItemIds` string[], nullable: Associated Line Item Ids
      - `brandId` integer, nullable: Brand Id
      - `creativeFormatType` 'Unknown' | 'FlagShip' | 'Showcase' | 'SponsoredProducts' | 'Butterfly' | 'BundleBoost' | 'IAB' | 'CUSTOM' | 'DisplayPanel' | 'DigitalShelfTalker', required: Creative format type
      - `environments` PageTypeEnvironment202210[], required: Environment type (e.g. mobile, web, app)
        - `environments` string[], nullable: List of environments per PageType
        - `pageType` 'Search' | 'Home' | 'Browse' | 'Checkout' | 'Category' | 'ProductDetail' | 'Confirmation' | 'Merchandising' | 'Deals', nullable: Creative PageType
      - `formatId` integer, required: Format Id
      - `id` string, nullable
      - `name` string, required: Name
      - `retailerId` integer, required: Retailer Id
      - `status` 'Ready' | 'In_Use' | 'Archived' | 'Deleted', required: Creative Status
      - `templateId` integer, required: Template Id
      - `templateName` string, required: Template Name
      - `templateVariableValues` TemplateVariableValue[], required: The template chosen values
        - `choiceVariableValue` ChoiceVariableValue, nullable: A value of a template choice variable (among different accepted options)
          - `chosenOptions` string[], required: The chosen options
        - `colorVariableValue` ColorVariableValue, nullable: A value of a template color variable
          - `color` string, nullable, required: The displayed color (HEX format)
        - `filesVariableValue` FilesVariableValue, nullable: A value of a template file variable (one or several files), like images in a creative
          - `assetIds` string[], required: The assets representing the images to be displayed
        - `hyperlinkVariableValue` HyperlinkVariableValue, nullable: A value of a template hyperlink variable
          - `url` string, nullable, required: The url to redirect to
        - `id` string, required: The id of the template variable the value is applied to
        - `textVariableValue` TextVariableValue, nullable: A value of a template text variable
          - `text` string, nullable, required: The displayed text
        - `videoVariableValue` VideoVariableValue, nullable: A value of a template video variable
          - `duration` string, required: The video's duration
          - `height` integer, required: The video's height
          - `url` string, required: The vast video url
          - `width` integer, required: The video's width
      - `updatedAt` string, date-time, nullable: Updated at time
    - `id` string, nullable: Unique identifier of this resource.
    - `type` string, nullable
  - `errors` CommonProblem[], nullable
    - `code` string, nullable: A machine-readable error code, expressed as a string value.
    - `detail` string, nullable: A human-readable explanation specific to this occurrence of the problem
    - `instance` string, nullable: A URI that identifies the specific occurrence of the problem.
    - `source` object, nullable: A machine-readable structure to reference to the exact location(s) causing the error(s)
    - `stackTrace` string, nullable
    - `title` string, nullable: A short human-readable description of the problem type
    - `traceId` string, nullable: The request correlation ID this problem comes from.
    - `traceIdentifier` string, nullable: The request correlation ID this problem comes from. (deprecated, use traceId instead)
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable: The problem's category.
  - `warnings` CommonProblem[], nullable
    - `code` string, nullable: A machine-readable error code, expressed as a string value.
    - `detail` string, nullable: A human-readable explanation specific to this occurrence of the problem
    - `instance` string, nullable: A URI that identifies the specific occurrence of the problem.
    - `source` object, nullable: A machine-readable structure to reference to the exact location(s) causing the error(s)
    - `stackTrace` string, nullable
    - `title` string, nullable: A short human-readable description of the problem type
    - `traceId` string, nullable: The request correlation ID this problem comes from.
    - `traceIdentifier` string, nullable: The request correlation ID this problem comes from. (deprecated, use traceId instead)
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable: The problem's category.

---

[API](https://skmtc.dev/criteo/apis/criteo-api.md) - [All operations](https://skmtc.dev/criteo/apis/criteo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/criteo/apis/criteo-api/revisions/c1721589426a?raw)