update_layer
Change specific properties of an existing animation layer by ID, such as position, size, timing, text, color, or media, without recreating it.
Instructions
Update properties of an existing layer. Only provide fields you want to change.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"layerId": "<layerId>"
},
"name": "update_layer"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | No | X position in px (left edge of bounding box) | |
| y | No | Y position in px (top edge of bounding box) | |
| loop | No | Video/audio loop | |
| name | No | ||
| seed | No | Blob deterministic seed integer | |
| text | No | Text content (required when type=text) | |
| count | No | Repeater: number of copies | |
| endMs | No | Time (ms) when layer disappears | |
| muted | No | Video/audio muted | |
| phase | No | Wave phase offset in radians | |
| sides | No | Edge count for polygon/star (3-12) or blob (5-64) | |
| stepX | No | Repeater linear: x offset per copy (px) | |
| stepY | No | Repeater linear: y offset per copy (px) | |
| turns | No | Spiral turn count (0.5–20) | |
| width | No | Width in px | |
| height | No | Height in px | |
| scaleX | No | Horizontal scale (1 = 100%) | |
| scaleY | No | Vertical scale (1 = 100%) | |
| volume | No | Video/audio volume 0–1 | |
| assetId | No | Media: id of an existing scene asset (see list_assets) | |
| layerId | Yes | ID of the layer to update | |
| opacity | No | Opacity 0-1 | |
| startMs | No | Time (ms) when layer becomes visible | |
| endAngle | No | End angle for arc/ring in degrees | |
| fontSize | No | ||
| parentId | No | Parent group layer id | |
| amplitude | No | Wave peak height in px | |
| endRadius | No | Spiral outer ending radius in px | |
| fillColor | No | Fill hex color e.g. "#3B82F6" | |
| frequency | No | Wave full-cycle count across width (0.1–50) | |
| objectFit | No | Image fit mode (default contain) | |
| requestId | No | ||
| sessionId | No | ||
| shapeKind | No | Shape geometry kind | |
| textAlign | No | ||
| textColor | No | ||
| tightness | No | Spiral radius interpolation exponent (1=linear) | |
| fontFamily | No | ||
| fontWeight | No | ||
| startAngle | No | Start angle for arc/ring in degrees | |
| stepScaleX | No | Repeater: scaleX step per copy | |
| stepScaleY | No | Repeater: scaleY step per copy | |
| fillOpacity | No | ||
| innerRadius | No | Inner radius for star/ring | |
| polarRadius | No | Repeater polar: ring radius (px) | |
| rotationDeg | No | Rotation in degrees | |
| startRadius | No | Spiral inner starting radius in px | |
| stepOpacity | No | Repeater: opacity step per copy | |
| strokeColor | No | ||
| strokeWidth | No | ||
| cornerRadius | No | ||
| irregularity | No | Blob noise ratio 0–1 | |
| repeaterMode | No | Repeater layout | |
| stepRotation | No | Repeater: rotation step per copy (deg) | |
| letterSpacing | No | ||
| polarEndAngle | No | Repeater polar: end angle (deg) | |
| sourceLayerId | No | Repeater: id of the layer to repeat | |
| polarStartAngle | No | Repeater polar: start angle (deg) | |
| expectedRevision | No |