API Reference

Trigger a Fleet to run with optional override data

Log in to see full request history

Overrides

Values configured on the target Fleet can be overridden by providing an optional JSON body in the request. Below is an example payload.

{ "vessel_overrides": [ { "name": "Vessel A", "environment_variable_overrides": { "ENV_VAR_1": "One", "ENV_VAR_2": "Two", "ENV_VAR_3": "Three", "explicit_empty": "", "explicit_do_not_set": None } }, { "name": "Vessel B", "environment_variable_overrides": { "ENV_VAR_A": "Apple", "ENV_VAR_B": "Blossom", "ENV_VAR_C": "Chai" } } ] }

There are several things to note regarding the json payload.

  1. The name value is the name of the Vessel that you'd like to override.
  2. environment_variable_overrides are the environment variables you'd like to override.
  3. Replace the left-hand side with the name of the environment variable you'd like to override and the right-hand side with the new value.
    1. Note: This is case sensitive.
  4. If the environment variable override value is an empty string "", the variable will be overridden and set to empty.
  5. If the environment variable override value is null or none, that value will be ignored and not set.
  6. If the environment variable override is not provided, the value set in the UI will be used.
Path Params
string
required

UUID of the Organization the Fleet is in

string
required

UUID of the Project the Fleet is in

string
required

UUID of the Fleet you want to run

Body Params
vessel_overrides
array of objects

Optional overrides for the target Fleet

vessel_overrides
Responses

Language
Credentials
Click Try It! to start a request and see the response here! Or choose an example:
application/json