Get campaign tree
Returns the Koast-tracked campaign STRUCTURE (campaign → adset → ad tree with IDs and names only) for a given campaign launch.
Tool name: get-campaign-tree.
Returns the Koast-tracked campaign STRUCTURE (campaign → adset → ad tree with IDs and names only) for a given campaign launch. Use ONLY to discover IDs or verify what's in Koast. Do NOT use for: ad/adset details (use getAdsetDetails / getAdDetails), campaigns not yet in Koast (use listAccountCampaigns), naming conventions (use getAccountNamingConvention), or creative fatigue (use computeCreativeFatigue). Does NOT include settings, metrics, or creative data. campaignLaunchId is required on every call.
When to use
View the Koast-tracked campaign structure (IDs, names, statuses only) to discover IDs or verify what is in a launch. campaignLaunchId is required: read it from the Current Context block, or resolve it from a mention. NOT for adset/ad details, campaigns that live only on the ad platform, naming conventions, metrics, or creative fatigue, delegate to the specialist tool for those.
Access
| Property | Value |
|---|---|
| Required scope | read |
| Publishes | No |
| Read-only | Yes |
| Destructive | No |
| Idempotent | Yes |
| Open world | No |
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. |
Output
| Field | Type | Required | Description |
|---|---|---|---|
summary | string | Yes | |
counts | object | Yes | |
importInProgress | boolean | Yes | |
tree | object | null | Yes |
REST equivalent
GET /v1/brands/{brandId}/launches/{launchId}/tree, Get campaign tree. CLI: koast get-campaign-tree.