SavePreset

Create or update a named preset which can be applied as a template for future jobs.

Request

<?xml version="1.0"?>
<query>
    <userid>[UserID]</userid> <!-- required-->
    <userkey>[UserKey]</userkey> <!-- required-->
    <action>savePreset</action>
    <name>[PresetName]</name>
    <format> <!-- REQUIRED -->
        <output>[output]</output> <!-- REQUIRED -->
        [FormatParams]
    </format>
</query>
{
    "query": {
        "userid": "[UserID]",
        "userkey": "[UserKey]",
        "action": "savePreset",
        "name": "[PresetName]",
        "format": {
            "output": "[output]"
        }
    }
}
ParameterDescriptionAllowed ValuesDefault Value
nameSpecify the preset name.StringIf not specified, preset name will be based on output name.
formatSpecify the preset format.Same as AddMedia sectionNone

Response

<?xml version="1.0"?>
<response>
    <message>Saved</message>
    <SavedPreset>[PresetName]</SavedPreset>
    <SavedPreset><!-- Each specified format would be saved as separate preset --></SavedPreset>
</response>
{
    "response": {
        "message": "Saved",
        "SavedPreset": [
            "[PresetName]"
        ]
    }
}

👍

Note

Presets can also be saved using an AddMedia request by specifying the preset name in the <save_preset> parameter in the section of the request. An example is below.

Request

<?xml version="1.0"?>
<query>
    <userid>[UserID]</userid> <!-- required-->
    <userkey>[UserKey]</userkey> <!-- required-->
    <action>addMedia</action>
    <format> <!-- REQUIRED -->
        <output>[output]</output> <!-- REQUIRED -->
        [FormatParams]
        <save_preset>[PresetName]</save_preset>
    </format>
</query>
{
    "query": {
        "userid": "[UserID]",
        "userkey": "[UserKey]",
        "action": "addMedia",
        "format": {
            "output": "[output]",
            "save_preset": "[PresetName]"
        }
    }
}

Response

<?xml version="1.0"?>
<response>
    <message>[ResponseMessage]</message>
    <SavedPreset>[PresetName]</SavedPreset>
</response>
{
    "response": {
        "message": "[ResponseMessage]",
        "SavedPreset": "[PresetName]"
    }
}