Settings

>>>

GET /api/settings
List all settings

Params

Param name Description
search
optional

filter results

Validations:

  • Must be a String
order
optional

Sort and order by a searchable field, e.g. '<field> DESC'

Validations:

  • Must be a String
page
optional

Page number, starting at 1

Validations:

  • Must be a number.
per_page
optional

Number of results per page to return, 'all' to return all results

Validations:

  • Must match regular expression /\A([1-9]\d*|all)\Z$/.

Search fields

Field name Type Possible values
description
id integer
name string
>>>

GET /api/settings/:id
Show a setting

Params

Param name Description
id
required

Validations:

  • Must be a String
>>>

PUT /api/settings/:id
Update a setting

Examples

PUT /api/settings/http_proxy_except_list
{
  "id": "http_proxy_except_list",
  "name": "http_proxy_except_list",
  "category": "general",
  "description": "Set hostnames to which requests are not to be proxied. Requests to the local host are excluded by default.",
  "settingsType": "array",
  "default": [],
  "readonly": false,
  "fullName": "HTTP(S) proxy except hosts",
  "configFile": null,
  "selectValues": null,
  "value": [
    "testArr",
    "testArr2"
  ],
  "encrypted": false
}
200
{
  "description": "Set hostnames to which requests are not to be proxied. Requests to the local host are excluded by default.",
  "settings_type": "array",
  "default": [],
  "updated_at": "2025-08-20 10:30:31 UTC",
  "id": "http_proxy_except_list",
  "name": "http_proxy_except_list",
  "full_name": "HTTP(S) proxy except hosts",
  "value": [
    "testArr",
    "testArr2"
  ],
  "category": "general",
  "category_name": "General",
  "readonly": false,
  "config_file": null,
  "encrypted": false,
  "select_values": null
}

Params

Param name Description
id
required

Validations:

  • Must be a String
setting
required

Validations:

  • Must be a Hash
setting[value]
optional

Validations:

  • Must be a String