Skip to main content

Default settings

Are you using only one endpoint in your project and you are tired of pasting {{endpoint}} into every endpoint field? Do you want to use gRPC-Web for a bunch of request? Or do you want to ignore the TLS server certificate validation for all operations when working locally? Then this feature is for you.

Note that this are default settings. You can still overwrite them in folders and operations.

Project default settings#

Project default settings apply to the whole project (unless overwritten of course). In the menu, click Project → Default settings to access the default settings.

The project default settings view

In this example, a default endpoint and a metadata entry has been configured for all environments. These settings will apply as long as they are not overwritten via directory default settings or in the operation itself.

Directory default settings#

You can also configure default settings for a directory, which only apply to subdirectories and operations within that directory. To do that, select a directory in the operation list.

A directory has been selected to configure the directory default settings

If you specify values in the directory default settings, they will overwrite the values defined in the project default settings or parent directory settings. However, if you leave some values empty, the project (or parent directory) default values will still apply.

In the example, you can see that the endpoint and the metadata entry were left blank and thus the project default settings apply.

Default settings for a specific environment#

By default, default settings will be applied regardless of the currently active environment. Sometimes, it is useful to specify default values only for specific environments.

A directory has been selected to configure the directory default settings

In the example, the server certificate validation was disabled, but only for the selected "Staging" environment. You can also see (indicated by the color) that the endpoint field and the gRPC mode entry were left blank, meaning that the "parent" default settings still apply.

Clarifications#

If default values are left blank, they are ignored (meaning that the "parent" default values apply).

Arrays of default values, such as gRPC metadata, can only be appended to. Removing or overwriting values is not supported.

Settings (ex. the endpoint) are applied in the following order (higher numbers are applied later and thus overwrite previous default settings):

  1. Project default settings (for all environments)
  2. Project default settings (for the current environment)
  3. Starting with the top-most directory, apply this for each directory, then go to the next subdirectory (until the directory is reached which contains the operation)
    1. Directory default settings (for all environments)
    2. Directory default settings (for the current environment)
  4. Operation settings