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

library_creative_update

Rename a Creative of your Library. The name is the only field that changes.

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

“Rename the Spring sale creative to Summer sale.”

The agent finds the Creative with library_creative_list, and calls this tool with the new name. You then see the Creative with its new name. To use another file in the Creative, the agent removes a Variation with variation_remove and adds one with variation_add.

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

Reference

Change the name of a Creative of your Library. The name is the only field that changes: to change a Variation, remove it with variation_remove and add a new one with 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.
name string, at most 255 characters or null yes 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 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.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 rename.
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",
  "name": "Summer sale"
}

The result, in structuredContent:

{
  "creative": {
    "createdAt": 1790000300000,
    "createdBy": "usr_2e5b84",
    "deletedAt": null,
    "id": "crv_5e2a19",
    "name": "Summer sale",
    "organizationId": "org_3a7f10",
    "updatedAt": 1790000900000,
    "variationCount": 2
  }
}

Was this page helpful?