delete_microsoft_ad_extensions

PERMANENTLY delete ad extension(s) from the account library. Irreversible. Dissociate from all entities first if the API refuses. Deletes live state.

Request body

All tool arguments are wrapped in an arguments object.

Field	Type	Description
`account_id`	`string` optional	Microsoft Advertising ad account id (numeric AccountId — NOT the 8-character account number shown in the UI). Get it from list_microsoft_accounts. Required when more than one account is connected; may be omitted with exactly one. `customer_id` is accepted as an alias. If the tool replies that several accounts are connected, re-run with this set — that reply is NOT a connection problem.
`customer_id`	`string` optional	Alias of account_id.
`ad_extension_ids`	`array` required	Ad extension id(s) to PERMANENTLY delete from the library. ⛔ Irreversible. Dissociate from all entities first if the API refuses.

Field

Type

Description

account_id

string optional

Microsoft Advertising ad account id (numeric AccountId — NOT the 8-character account number shown in the UI). Get it from list_microsoft_accounts. Required when more than one account is connected; may be omitted with exactly one. `customer_id` is accepted as an alias. If the tool replies that several accounts are connected, re-run with this set — that reply is NOT a connection problem.

customer_id

string optional

Alias of account_id.

ad_extension_ids

array required

Ad extension id(s) to PERMANENTLY delete from the library. ⛔ Irreversible. Dissociate from all entities first if the API refuses.

Example request

{ "arguments": { "ad_extension_ids": [ "string" ], "account_id": "string", "customer_id": "string" } }

Example responses

200 — Success

{ "success": true, "data": { "text": "(tool-specific textual output for delete_microsoft_ad_extensions)", "quota": { "used": 42, "limit": 150, "tier": "plus", "period_end": "2026-05-01" } }, "tool": "delete_microsoft_ad_extensions" }

400 — Tool-level error (bad arguments / multi-account selection)

{ "success": false, "error": "You have 25 meta_ads accounts connected. Please specify which account to use by passing the ad_account_id parameter:\n - Acme Holdings (ad_account_id=\"act_123456789\")\n - Acme EU (ad_account_id=\"act_987654321\")", "is_error": true, "tool": "delete_microsoft_ad_extensions" }

402 — Quota exhausted

{ "success": false, "error": "\ud83d\udea8 Monthly limit reached (150/150 tool calls on Plus tier).\nUpgrade to Pro at https://adspirer.ai to keep building.", "is_error": true, "tool": "delete_microsoft_ad_extensions", "quota": { "used": 150, "limit": 150, "tier": "plus", "period_end": "2026-05-01", "upgrade_url": "https://adspirer.ai" } }

Interactive: Swagger UI

Machine-readable: OpenAPI 3.1 spec · llms-full.txt

More tools: Microsoft Advertising · All tools

Endpoint

Headers