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_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.
- 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
}
}