---
title: "/2026-01/retail-media/line-items/{id}/keywords/add-remove"
method: POST
path: "/2026-01/retail-media/line-items/{id}/keywords/add-remove"
tags: ["Campaign"]
---

# /2026-01/retail-media/line-items/{id}/keywords/add-remove

`POST /2026-01/retail-media/line-items/{id}/keywords/add-remove`

Add or Remove keywords from the line item in bulk

## Path parameters

- `id` string, required

## Request body

- AddRemoveKeywordsModelRequest — Request object to add or remove keywords from a line item
  - `data` AddRemoveKeywordsModelResource — Resource object containing keywords to be added or removed from a line item
    - `attributes` AddRemoveKeywordsModel — Data model containing keywords to be added or removed from a line item
      - `keywords` AddRemoveKeywordModel[], nullable
        - `isDeleted` boolean
        - `matchType` 'PositiveExactMatch' | 'NegativeExactMatch' | 'NegativeBroadMatch' — The match type of a keyword.
        - `phrase` string, nullable
    - `id` string, nullable
    - `type` string, nullable

## Response `200`

Success

- ResourceOutcome — Outcome object containing errors and warnings.
  - `errors` RmcaCommonProblem[], 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
    - `status` integer, nullable — The problem's HTTP Status code.
    - `title` string, nullable — A short human-readable description of the problem type
    - `traceId` string, nullable — The request correlation ID this problem comes from.
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable — The problem's category.
  - `warnings` RmcaCommonProblem[], 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
    - `status` integer, nullable — The problem's HTTP Status code.
    - `title` string, nullable — A short human-readable description of the problem type
    - `traceId` string, nullable — The request correlation ID this problem comes from.
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable — The problem's category.

---

[API](https://skmtc.net/criteo/apis/criteo-api.md) · [All operations](https://skmtc.net/criteo/apis/criteo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/criteo/criteo-api/revisions/c1721589426a/schema)