# text.set

> Changes the content or the style of a text item.

Source: https://alexgalhardo.github.io/vukem-video/pt-br/docs/reference/commands/text.set

Replaces the text, merges a partial style into the stored one (null removes a key), or empties the style first with reset_style. At least one of text, style and reset_style is required.

## Arguments

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `item_id` | `string` | yes | A text item. |
| `reset_style` | `boolean` | no | Empty the stored style before applying style. |
| `style` | `object` | no | A partial TextStyle, merged; null removes a key. |
| `text` | `string` | no |  |

## Example

As one operation of an `edit` batch (the `edit` tool of MCP, `vukem-video edit --ops`, or `POST /api/v1/projects/{id}/edit`):

```json
{
  "op": "text.set",
  "args": {
    "item_id": "itm_s6t7v8w9x0",
    "style": {
      "color": "#FFE600"
    },
    "text": "Hello world"
  }
}
```

## Errors

[`E_VALIDATION`](/docs/reference/error-codes#e_validation), [`E_NOT_FOUND`](/docs/reference/error-codes#e_not_found), [`E_TYPE_MISMATCH`](/docs/reference/error-codes#e_type_mismatch), [`E_FONT_UNKNOWN`](/docs/reference/error-codes#e_font_unknown)

## Scope and phase

Scope `edit`, phase `prototype`. Run `vukem-video command:help text.set` for the same description from the binary.
