.. _api-global-settings:

Settings - ``api/v1/settings``
------------------------------

This is an authenticated API. Only Admins and Service Accounts can use the Settings API.

GET /api/v1/settings
^^^^^^^^^^^^^^^^^^^^
Get a list of settings objects (there should only ever be one), including the ids.

GET /api/v1/settings/:id
^^^^^^^^^^^^^^^^^^^^^^^^
Get the settings object.

PUT /api/v1/settings/:id
^^^^^^^^^^^^^^^^^^^^^^^^
Update the entire settings object.

PATCH /api/v1/settings/:id
^^^^^^^^^^^^^^^^^^^^^^^^^^
Partially update the settings object.