Update Campaign Ad

PATCH

/ad-campaigns/{campaign_id}/ads/{ad_id}

• Production
• QA

Edit one ad’s creative.

Check replaced_platform_ad in the response: on a live campaign most creative edits archive the platform ad and create a new one, restarting policy review and delivery learning. The graph8 ad id and its measurement history survive that.

Authorizations

• BearerAuth

Parameters

Path Parameters

campaign_id

required

Ad campaign ID

integer

Ad campaign ID

ad_id

required

Graph8 ad ID

integer

Graph8 ad ID

Header Parameters

X-Target-Org-Id

Any of:

string

string

null

null

Request Body ^required

Edit one ad. Omitted fields are unchanged.

On a live campaign a creative change is applied as a REPLACE, because that is what the platforms permit. The response reports whether the platform ad was replaced so a caller knows review and learning restarted.

object

copy_assets

Any of:

object

object

key

additional properties

any

null

null

creative_image_url

Any of:

string

string

<= 500 characters

null

null

creative_image_url_portrait

Any of:

string

string

<= 500 characters

null

null

creative_image_url_square

Any of:

string

string

<= 500 characters

null

null

cta

Any of:

string

string

<= 50 characters

null

null

description

Any of:

string

string

<= 1000 characters

null

null

destination_url

Any of:

string

string

<= 500 characters

null

null

headline

Any of:

string

string

<= 255 characters

null

null

logo_image_url

Any of:

string

string

<= 500 characters

null

null

name

Any of:

string

string

<= 255 characters

null

null

primary_text

Any of:

string

string

<= 1000 characters

null

null

source_ad_creative_id

Any of:

string

string

<= 64 characters

null

null

Responses

200

Successful Response

object

data

required

object

ad

required

One ad inside a campaign — a creative slot.

id is graph8’s, and it is stable: editing an ad almost always mints a new platform ad (LinkedIn creatives are immutable, and on Google only Search/RSA is mutable in place), but the slot and its measurement history survive that. Address an ad by this id, never by platform_ad_id.

object

approval_nuance

Any of:

string

string

null

null

campaign_id

required

integer

copy_assets

Any of:

object

object

key

additional properties

any

null

null

created_at

Any of:

string

string

null

null

creative_image_url

Any of:

string

string

null

null

creative_image_url_portrait

Any of:

string

string

null

null

creative_image_url_square

Any of:

string

string

null

null

cta

Any of:

string

string

null

null

description

Any of:

string

string

null

null

destination_url

Any of:

string

string

null

null

error_message

Any of:

string

string

null

null

headline

Any of:

string

string

null

null

id

Any of:

integer

integer

null

null

launched_at

Any of:

string

string

null

null

logo_image_url

Any of:

string

string

null

null

name

Any of:

string

string

null

null

platform_ad_id

Any of:

string

string

null

null

policy_topics

Any of:

Array<object>

Array<object>

object

key

additional properties

any

null

null

primary_text

Any of:

string

string

null

null

slot_index

required

integer

source_ad_creative_id

Any of:

string

string

null

null

status

required

Draft | launching | active | paused | archived | failed

string

changed

required

Array<string>

consequences

Policy_review | learning_reset

Array<string>

replaced_platform_ad

required

True when the platform ad was recreated; review and learning restart

boolean

pagination

Any of:

PaginationMeta

object

has_next

required

Whether there are more pages

boolean

limit

required

Items per page

integer

next_cursor

Any of:

string

string

null

null

page

required

Current page number (1-indexed)

integer

total

required

Total number of items

integer

null

null

422

Validation Error

object

detail

Array<object>

object

loc

required

Array

msg

required

string

type

required

string