Duplicate and vary

Duplicates the node count times and sets one settings path, vary.path, to a different value on each copy, taken in order from vary.values (its length must equal count). Paths and values are validated against the settings schema. nameTemplate names the copies.

POST

/v1/brands/{brandId}/launches/{launchId}/nodes/{nodeId}/variations

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

Request Body

application/json

body

count*number

Range1 <= value <= 20

vary*

nameTemplate?string

Optional name template, e.g., "{original} - Variant {i}"

Response Body

Duplicate and vary

application/json

response

[key: string]?unknown

curl -X POST "https://example.com/v1/brands/0/launches/string/nodes/string/variations" \  -H "Authorization: Bearer koast_sk_..." \  -H "Content-Type: application/json" \  -d '{    "count": 1,    "vary": {      "path": "string",      "values": [        null      ]    }  }'

{  "property1": null,  "property2": null}

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