library_creative_delete
Delete a Creative of your Library and its Variations. The Assets stay in the Library.
Ask to remove an ad idea from your Library. The agent deletes the Creative, and each of its Variations goes with it in one step.
“Delete the Spring sale creative.”
The agent finds the Creative with library_creative_list, and calls this tool. You see how many Variations the delete removed. The files stay in your Library as Assets, and no ad account changes.
This tool is part of the job Bring your own creative.
Reference
Delete a Creative of your Library, and each of its Variations with it, in one step. The Assets of the Variations stay in the Library. No ad account changes. A Creative of your Library is an ad idea of your organization, with its Variations. It is not the creative of an ad account, which list_creatives lists.
Input
| Argument | Type | Required | Description |
|---|---|---|---|
creative_id |
string | yes | The id of a Creative of your Library (crv_…). library_creative_list gives it. |
Output
A successful call returns this object in structuredContent.
| Field | Type | Always present | Description |
|---|---|---|---|
creativeId |
string | yes | The id of the deleted Creative, crv_…. |
deleted |
true |
yes | |
removedVariations |
number | yes | How many Variations the delete removed with the Creative. Their Assets stay in the Library. |
Failure codes
A failed call has isError set, and structuredContent.error holds one of these codes. Errors describes the shape of a failed call.
not_foundorganization_unentitledforbiddeninvalid_requestinternal_error
Scope
The token must hold library:write. Auth & scopes lists each scope.
Annotations
A client reads these hints. A hint that the tool does not declare has the default value of the MCP specification.
- Writes. The tool can change data.
- Destructive. The tool can make a change that you cannot undo. A client can ask you to confirm before it calls the tool.
- Not idempotent. A second call with the same arguments can change more.
- Closed world. The tool reads and writes the data of AdCrunch only.
Example
The arguments:
{
"creative_id": "crv_5e2a19"
}
The result, in structuredContent:
{
"creativeId": "crv_5e2a19",
"deleted": true,
"removedVariations": 2
}