Edit an ad

PATCH /api/marketing/ads/{adId}

Name, status, creative and tracking_specs can be changed. adset_id is immutable: if it is sent, the response is 400. To move an ad to another ad set you must create a new one. Requires the marketing:manage scope.

Request body

Field	Type		Description
`ad_account_id`	string	required	Ad account that owns the ad. Example: `"act_123"`.
`name`	string	optional	—
`status`	`ACTIVE` · `PAUSED` · `DELETED` · `ARCHIVED`	optional	—
`creative`	AdCreativeRefDto	optional	—
`tracking_specs`	object[]	optional	—
`adset_id`	string	optional	NOT accepted: moving an ad to another ad set is 400. Create a new one.

Responses

Status	Description	Schema
`200`	—	AdDto

Example

curl -X PATCH https://api.neike.dev/api/marketing/ads/{adId} \
  -H "x-neike-api-key: whk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
       "ad_account_id": "act_123"
     }'

AdDto

Field	Type		Description
`id`	string	required	Example: `"120210000000000000"`.
`name`	string	required	Example: `"Anuncio tráfico · imagen"`.
`adset_id`	string	optional	—
`campaign_id`	string	optional	—
`status`	`ACTIVE` · `PAUSED` · `DELETED` · `ARCHIVED`	optional	—
`effective_status`	string	optional	Status computed by Meta, includes the review status.
`creative`	AdCreativeRefDto	optional	—
`created_time`	string	optional	—
`updated_time`	string	optional	—