audio
An audio track. animated designs only — an audio layer on a static, printer or printer_multipage payload is rejected with unknown_enum_value.
| Property | Type | Notes |
|---|---|---|
src | string | Required. A filename or public https:// URL — either must carry a .mp3 or .wav extension — or a data URI (data:audio/mpeg, audio/mp3, audio/wav, audio/x-wav). See Create Import → src resolution. |
muted | boolean | Renders the track silent. Defaults to false. |
max_volume | float | 0 – 1. Omitted plays at full volume. |
muted and max_volume are not independent: a muted track is stored with its volume zeroed, so muted: true wins over any max_volume you also send.
Extensions are matched case-insensitively. Using a media extension on an image or logo layer's src is rejected with unsupported_for_type — use this layer type instead.
Size limits
An audio file uploaded through a presigned URL may be up to 25 MB. A data URI is capped at 2 MB decoded.
Layout is required, and ignored
An audio layer has no visual box, but layout is required like on every other layer. Supply a placeholder — { "x": 0, "y": 0, "width": 1, "height": 1 } — and note that the platform stores audio at zero extent regardless of what you send. An exported audio layer therefore comes back with a 1×1 layout rather than the one you supplied.
Timing
An audio track uses the same animation object as every other layer to say when it starts and stops (start_at_s / end_at_s), and it may carry an audioFade tween. See Animated Imports.
Unlike video, an audio layer may be a group member.