Apply edit commands

Applies a batch of commands and saves a new version. The batch applies whole or not at all. A bad command changes nothing and answers 422 with what to send instead. Free.

Authorization

bearerAuth

AuthorizationBearer <token>

API key authentication. Use your API key as the bearer token: Authorization: Bearer roasos_sk_...

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

commands*array<>

Applied in order, all or none. Clip numbers update after each command. insert_clip(source,at?,source_in_seconds?,duration_seconds?); remove_clip(clip); move_clip(clip,to); duplicate_clip(clip); replace_clip(clip,source,source_in_seconds?); split_clip(clip,at_seconds); trim_clip(clip,source_in_seconds?,source_out_seconds?,duration_seconds?); set_speed(clip,speed,keep?); set_fit(fit,clip?); set_framing(clip,x?,y?,scale?,rotation?,flip_h?,flip_v?); set_volume(volume?,muted?,clip?,audio?,all_clips?); set_transition(clip,transition,duration_seconds?); set_effect(clip,effect); set_image(clip,duration_seconds?,motion?,motion_amount?); set_output(ratio); set_voice(source,start_seconds?,volume?,replace?,mute_clips?); set_music(source,start_seconds?,duration_seconds?,volume?,fade_in_seconds?,fade_out_seconds?,duck?); update_audio(audio,start_seconds?,volume?,fade_in_seconds?,fade_out_seconds?,duck?); remove_audio(audio); fit_clips_to_voice(tail_seconds?); set_captions(captions); captions_from_script(script,words?,audio?,max_words?,max_chars?); edit_caption(caption,text?,start_seconds?,duration_seconds?); remove_caption(caption); clear_captions(); set_caption_style(preset?,color?,uppercase?,highlight?,position?,x?,y?); add_overlay(text,style?,sub?,start_seconds?,from_end_seconds?,duration_seconds?,x?,y?,animation?,color?); edit_overlay(overlay,text?,style?,sub?,start_seconds?,from_end_seconds?,duration_seconds?,x?,y?,animation?,color?); remove_overlay(overlay)

Items1 <= items <= 50

expected_version?integer

Refuses the batch if the edit has changed since this version.

Range0 <= value

Response Body

`application/json`

curl -X POST "https://example.com/v1/edits/497f6eca-6276-4993-bfeb-53cbbbba6f08/commands" \  -H "Content-Type: application/json" \  -d '{    "commands": [      {        "type": "insert_clip",        "property1": null,        "property2": null      }    ]  }'

{  "data": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "title": "string",    "version": 0,    "latest_version": 0,    "length_seconds": 0,    "property1": null,    "property2": null  }}

Apply edit commands

Authorization

Path Parameters

Request Body

Response Body

200application/json

404application/json

409application/json

422application/json

`application/json`

`application/json`

`application/json`

`application/json`