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.

PATCH

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

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 update

Length1 <= length

Request Body

application/json

body

creativeId?number

Numeric creative ID to attach to an ad node. Use this when the user says "use this creative" or selects a creative from the attachments panel.

copyGenerationId?number

Numeric copy generation ID to attach to an ad node. Use this AFTER calling generateCopy, take the returned id and pass it here on the target ad.

postId?string

Existing Meta post ID to attach to an ad node.

properties?

Other key-value pairs to update (e.g., { name: "New name" }). Do NOT put creativeId / copyGenerationId / postId here, use the dedicated fields above.

Response Body

Update campaign, ad set or ad

application/json

response

[key: string]?unknown

curl -X PATCH "https://example.com/v1/brands/0/launches/string/nodes/string" \  -H "Authorization: Bearer koast_sk_..." \  -H "Content-Type: application/json" \  -d '{}'

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

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