<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Suggests one new keyword theme to replace one you rejected, for a campaign you have not launched yet.

Send the theme to replace as current and every theme already in the campaign as existing. A language model writes one replacement from the app's own content, and Base44 checks that it differs from all of them, ignoring case.

The call returns a 200 with keyword_theme set to null when there is no new theme: the app has nothing to read, the model fails, or it only comes up with themes you already have. Keep the old theme then. Nothing is saved.

<Note>This endpoint runs a language model and draws on a shared quota of 20 requests per minute per app, which every Google Ads AI endpoint debits. Enterprise workspaces get a higher quota. A 429 means the quota is spent, not that this endpoint has its own limit.</Note>

It is refused with a 409 while the workspace is on a Google Ads billing hold. Running the model does not spend credits.

<Note>This endpoint accepts a personal API key from anyone who can edit the app. A read-only key is refused with a 403, and so are workspace API keys.</Note>

{
  "current": "phone repair",
  "existing": [
    "phone repair",
    "screen replacement",
    "battery replacement"
  ]
}

{
  "keyword_theme": "cracked screen fix"
}