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

library_creative_update

Change the name or the description of a Creative of your Library.

Ask to give a Creative another name, or a description. The agent changes the name, the description, or both, and the Variations stay as they are.

“Rename the Spring sale creative to Summer sale, and describe it as the teaser and the square banner.”

The agent finds the Creative with library_creative_list, and calls this tool with the new name, the new description, or both. A field that the agent leaves out does not change. You then see the Creative with its new text. To change the slot of a cut, the agent uses library_variation_update. To use another file in the Creative, the agent removes a Variation with library_variation_remove and adds one with library_variation_add.

This tool is part of the job Bring your own creative.

Reference

Change the name, the description, or both, of a Creative of your Library. A field that you leave out does not change. To change the Placement of a Variation, use library_variation_update. To use another Asset in the Creative, remove the Variation with library_variation_remove and add a new one with library_variation_add. 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.
description string, at most 1000 characters or null no A free text about the Creative, up to 1000 characters. A blank description or null stores no description.
name string, at most 255 characters or null no The name of the Creative, for people. A blank name or null stores no name. There is no fallback name.

Output

A successful call returns this object in structuredContent.

Field Type Always present Description
creative object yes The Creative with its new name and description, and its count of Variations.
creative.createdAt number yes Milliseconds since the Unix epoch, UTC.
creative.createdBy string yes The user who created the Creative.
creative.deletedAt number or null yes Always null here. A deleted Creative is not answered.
creative.description string or null yes A free text about the Creative. null when nobody wrote one. There is no fallback text.
creative.id string yes The id of the Creative, crv_….
creative.name string or null yes The name a person gave the Creative. null when nobody named it. There is no fallback name.
creative.organizationId string yes The organization that owns the Creative.
creative.updatedAt number or null yes When the Creative last changed, in milliseconds since the Unix epoch, UTC. null until its first update.
creative.variationCount number yes How many live Variations the Creative holds. The read of one Creative holds the first page of them, and the list of the Variations of the Creative gives each page.

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.
  • Not destructive. The tool makes only additive changes.
  • Idempotent. A second call with the same arguments changes nothing more.
  • Closed world. The tool reads and writes the data of AdCrunch only.

Example

The arguments:

{
  "creative_id": "crv_5e2a19",
  "description": "The summer sale, two cuts.",
  "name": "Summer sale"
}

The result, in structuredContent:

{
  "creative": {
    "createdAt": 1790000300000,
    "createdBy": "usr_2e5b84",
    "deletedAt": null,
    "description": "The summer sale, two cuts.",
    "id": "crv_5e2a19",
    "name": "Summer sale",
    "organizationId": "org_3a7f10",
    "updatedAt": 1790000900000,
    "variationCount": 2
  }
}

Was this page helpful?