# slot.mark

> Marks an item as a template slot.

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

Makes a clip, audio, text or caption item a slot named name; the slot kind follows from the item type (clip and audio give media). Marking the same item again with the same name updates the slot.

## Arguments

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `description` | `string` | no | Up to 200 characters. |
| `duration_policy` | `fit`, `stretch_timeline` | no | Media slots only. Default fit. |
| `item_id` | `string` | yes | A clip, audio, text or caption item. |
| `name` | `string` | yes | Matches [a-z][a-z0-9_]\{0,39\}; unique among the slots. |
| `required` | `boolean` | no | Default true. |

## 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": "slot.mark",
  "args": {
    "description": "Headline",
    "item_id": "itm_s6t7v8w9x0",
    "name": "title"
  }
}
```

## 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_SLOT`](/docs/reference/error-codes#e_slot), [`E_INVALID_STATE`](/docs/reference/error-codes#e_invalid_state)

## Scope and phase

Scope `edit`, phase `alpha`. Run `vukem-video command:help slot.mark` for the same description from the binary.
