figma_motion_set_keyframes
Create or update a manual Motion keyframe track on a Figma node for properties, paints, strokes, or effect fields; dry-run by default, then apply with verification and rollback on mismatch.
Instructions
Set one manual keyframe track on a node (Motion Beta): a property such as OPACITY/TRANSLATION_X/SCALE_XY, a paint/stroke, or an effect field. The track carries baseValue and keyframes with timelinePosition in seconds; positions must be unique and all values in one track must share a type. dryRun defaults to TRUE; apply re-reads and verifies every keyframe's position, value and easing, then rolls back on any mismatch. This writes Motion data; it never fabricates a local animation.
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": {
"field": "<field>",
"track": "<track>"
},
"name": "figma_motion_set_keyframes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| field | Yes | ||
| track | Yes | ||
| dryRun | No | TRUE (default): plan only, no document write. FALSE: apply in one undo transaction. | |
| nodeId | No | Defaults to the current single selection | |
| planId | No | The planId returned by the dry run. Apply is refused if the arguments or the node's Motion state changed. | |
| fileKey | No | Which connected Figma file to use: its fileKey (figma_whoami) or, when omitted, the only connected file. Required once more than one file is connected; figma_ping lists them. |