API referenceLaunches

Rename campaign, ad set or ad

Renames a campaign, ad set or ad in the launch to newName.

POST
/v1/brands/{brandId}/launches/{launchId}/nodes/{nodeId}/rename
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.

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 rename

Length1 <= length
Idempotency-Key?string

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

Lengthlength <= 255
application/json
  1. body
newName*string

New name for the node (must be non-empty)

Length1 <= length <= 500

Response Body

Rename campaign, ad set or ad

application/json
  1. response
[key: string]?unknown
curl -X POST "https://example.com/v1/brands/0/launches/string/nodes/string/rename" \  -H "Authorization: Bearer koast_sk_..." \  -H "Content-Type: application/json" \  -d '{    "newName": "string"  }'
{  "property1": null,  "property2": null}

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