API referenceLaunches

Duplicate ad set or ad

Duplicates an ad set or ad, including all its settings and children, count times (1-50).

POST
/v1/brands/{brandId}/launches/{launchId}/nodes/{nodeId}/duplicate

Authorization

bearerAuth
headerAuthorizationBearer <token>

An organization API key (koast_sk_…) with the API surface enabled, or an OAuth access token issued by Koast (koast_at_…) whose audience covers this API. REST access requires an active Agency plan.

Path Parameters

brandId*integer

The brand the request acts on. Every brand-scoped resource lives under its brand.

launchId*string

The campaign launch (batch) id.

nodeId*string

ID of the node to duplicate

Length1 <= length

Header Parameters

Idempotency-Key?string

Retrying with the same key within 24 hours returns the first response without acting again.

Lengthlength <= 255

Request Body

application/json
  1. body
nodeType*string

Type of the node to duplicate

Value in"adset""ad"
count?number

Number of copies to create (default 1, max 50)

Range1 <= value <= 50
Default1

Response Body

Duplicate ad set or ad

application/json
  1. response
success*boolean
count*number
nodeType*string
Value in"adset""ad"
curl -X POST "https://example.com/v1/brands/0/launches/string/nodes/string/duplicate" \  -H "Authorization: Bearer koast_sk_..." \  -H "Content-Type: application/json" \  -d '{    "nodeType": "adset"  }'
{  "success": true,  "count": 0,  "nodeType": "adset"}

Required scope: write. CLI: koast duplicate-node, see Launches commands. Authentication, headers, errors and pagination work the same on every operation. See Conventions.

Update campaign, ad set or ad

Updates a campaign, ad set or ad node. Attach a creative, a generated copy or an existing post to an ad with creativeId, copyGenerationId or postId; set other fields, such as status (PAUSED or ACTIVE), through properties. At least one of these must be provided.

Edit live campaign budget

Changes the daily or lifetime budget of a campaign or ad set that is already live, and pushes the change straight to the ad platform. amount is in cents (minimum 100). Returns 409 for a node that is still a draft; draft budgets are changed through the settings endpoint.