Skip to main content
POST
Update Meta Ad

Authorizations

Authorization
string
header
required

API key from https://adspirer.ai/keys. Prefix sk_live_. Treat as a secret — never commit.

Headers

Idempotency-Key
string<uuid>

Client-generated UUID to make writes idempotent. Strongly recommended for write tools. A repeat call with the same key returns the cached result instead of re-executing. Example: 550e8400-e29b-41d4-a716-446655440000

Body

application/json

All tool arguments are wrapped in an arguments object. The fields accepted inside arguments are listed below — required fields are marked with a red asterisk.

arguments
object
required

Input schema for updating a Meta ad.

Supported fields: status, name, creative_id.

NOT supported here: primary_text, headline, description, call_to_action_type. Meta does not allow editing creative text fields in-place. To change ad copy or CTA, create a new ad with the updated text using add_meta_ad, then pause the old ad.

Response

Tool executed successfully. data.text carries the human-readable result (markdown-friendly). data.quota shows your current usage against the plan limit. data.structured appears when the tool emits machine-parseable structured content. data.content appears for tools that return non-text blocks (images, resources).

Returned on HTTP 200. data.text is the primary human-readable output. data.quota is always present for billable calls. data.structured is set only when the tool emits machine-parseable structured content. data.content is set only when the tool emits non-text content blocks.

data
object
required
success
boolean
required
tool
string
required

Echoed tool_name from the request URL.

Last modified on April 23, 2026