Skip to content
AdCrunch
Esc
↑↓navigate↵open⌘Jpreview
On this page

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_found
  • organization_unentitled
  • forbidden
  • invalid_request
  • internal_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
}

Was this page helpful?