Add Canvas Animations
Add preset animations in one atomic batch (order preserved).
created_ids carries the new animation ids in entry order. Presets and
params are validated by the tool host; a rejected entry fails the whole
batch with the typed invalid_animation error and nothing applied.
Authorizations
API key from Settings > Developer > REST API
Headers
Calendar-dated API version pin. New integrations should pin 2026-05-01 to opt into the newest response shapes. For back-compat the server also accepts requests with no header and resolves them to the current default (today: 2026-04-12); that default advances on each sunset date. Any unsupported value returns 400 unsupported_version.
2026-04-12, 2026-05-01 "2026-05-01"
Path Parameters
Body
Animation entries (nodeId + preset required; optional trigger, durationMs, easing, params). The batch is atomic: one rejected entry applies nothing.
1 - 100 elementsOptional (advisory) — adds are additive.
200Response
Successful Response
The response is of type Response Canvasactionsaddanimations · object.