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_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",
"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
}
}