auto_write

Uses one take from a finished request for takes on a design. By default it is saved as a new version of the design it va

Uses one take from a finished request for takes on a design. By default it is saved as a new version of the design it varied, so the earlier version stays restorable. With as_new_design it becomes a design of its own in the same test group as the original, which keeps both: the way to put takes against each other in posts or ads. The take is applied to the newest version with the design's locks held; a take that no longer fits a design that changed since is refused. Costs no credits.

post/api/v1/tools/use_design_variation

Request

  • Base URL: https://app.magistry.io
  • URL: https://app.magistry.io/api/v1/tools/use_design_variation
  • 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

request_idstring required

The request that made the takes.

takeinteger required

The take's index, as the request's status lists it.

as_new_designboolean

Make it a design of its own in the original's test group (default false).

titlestring

The new design's name; the original's name and the take's title when left out.

axis'hook' | 'first_frame' | 'length' | 'voiceover' | 'music' | 'visual' | 'copy' | 'offer'

What the new design differs on from the original, so a test between them says what won.

Response

Tool result

okboolean required
resultunknown required

Changes

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