---
title: library_creative_update
description: 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`](/mcp/tools/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`](/mcp/tools/variation-remove) and adds one with [`variation_add`](/mcp/tools/variation-add).

This tool is part of the job [Bring your own creative](/mcp/tools/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](/mcp/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](/mcp/auth) 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:

```json
{
  "creative_id": "crv_5e2a19",
  "name": "Summer sale"
}
```

The result, in `structuredContent`:

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