Compute creative fatigue
Canonical deterministic creative fatigue score for a single ad (or aggregated set) on a campaign launch.
Tool name: compute-creative-fatigue.
Canonical deterministic creative fatigue score for a single ad (or aggregated set) on a campaign launch. The daily series is fetched server-side from the ad platform's live insights, you Do NOT pass it. Pass adId to score one ad; omit to score the whole launch at the chosen level. Use whenever the user asks about fatigue, creative decline, 'ads getting tired', or refresh candidates. Do NOT use getCampaignTree or other metrics tools for fatigue, this is the canonical fatigue signal.
When to use
Canonical deterministic fatigue score for a single ad (or aggregated set). The daily series comes from the same insights read used by getInsightsDaily, the agent never authors it. For standalone fatigue questions ("which creatives are fatiguing", "ads getting tired", "refresh candidates") this MUST be your FIRST tool call, never infer from getMetrics.
Access
| Property | Value |
|---|---|
| Required scope | read |
| Publishes | No |
| Read-only | Yes |
| Destructive | No |
| Idempotent | Yes |
| Open world | Yes |
Input
| Field | Type | Required | Description |
|---|---|---|---|
campaignLaunchId | string | Yes | Campaign launch ID (a.k.a. batch ID). Read it from the Current Context block when one is in scope, or resolve it from a mention via listAccountCampaigns / the campaign tree when the user @-mentioned a different launch. |
adId | string | No | Optional ad-platform ad id to score a single ad. When omitted, scores the aggregated series at the chosen level. |
level | string | No | Insight level; defaults to 'ad' since fatigue is a per-creative concept. One of campaign, adset, ad. Default "ad". |
days | integer | No | Lookback window in days. Defaults to 30. Default 30. Minimum 3, maximum 90. |
Output
| Field | Type | Required | Description |
|---|---|---|---|
score | number | null | Yes | |
components | object | Yes | |
status | string | Yes | One of insufficient data, no fatigue, early, active, exhausted. |
daysAnalyzed | number | Yes | |
source | "insights-daily" | Yes | |
asOf | string | No | ISO time of the live provider read behind this response. Set on MCP and API responses, which may be served from the short metrics cache. |
REST equivalent
GET /v1/brands/{brandId}/launches/{launchId}/creative-fatigue, Compute creative fatigue. CLI: koast compute-creative-fatigue.
Clone live campaign
Clone a live campaign into one or more fresh Koast batches as editable DRAFTS, a full deep-copy of the campaign tree (ad sets, ads, copy, re-imported creatives) with all ad-platform IDs stripped, so each clone is a brand-new launchable draft.
Create campaign launch
Create an empty campaign launch (batch) under a specific brand/ad account.