auto_write

Sets the soundtrack of a motion design from the store's music library, saved as a new version: puts a track under the wh

Sets the soundtrack of a motion design from the store's music library, saved as a new version: puts a track under the whole design, takes the music off, or changes how the current track plays — its volume, its fades and where in the track the design starts. No music is made, so no credits are used. Only for designs with a duration. Returns the soundtrack the saved version has.

post/api/v1/tools/set_design_audio

Request

  • Base URL: https://app.magistry.io
  • URL: https://app.magistry.io/api/v1/tools/set_design_audio
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.magistry.io/api/oauth/authorize, token URL https://app.magistry.io/api/oauth/token, scopes: creative:write)

Request body

design_idstring required

The motion design.

track_idstring nullable

A track id from the music library. null takes the music off; left out, the current track stays.

gain_dbnumber

Volume in decibels; 0 plays the track as it is, lower is quieter.

fade_in_secondsnumber

Fade in from silence, in seconds.

fade_out_secondsnumber

Fade out at the end, in seconds.

start_at_secondsnumber

Seconds into the track the design starts at; 0 when a new track is set.

Response

Tool result

okboolean required
resultunknown required

Changes

No recorded changes to this operation across all 2 revisions of this API.