system

Update system settings

Changed on Sep 12, 2026

Update the specified Cribl system settings.<br/><br/>Provide only the top-level sections (<code>api</code>, <code>workers</code>, <code>tls</code>, <code>proxy</code>, etc.) you want to change. Omitted sections stay unchanged. Each provided section fully replaces the existing one — send the complete section object, not only the changed fields.<br/><br/><code>api.loginRateLimit</code> and <code>api.ssoRateLimit</code> are deprecated. A new value is still applied, but it is stored as <code>rateLimits</code> in the API limits configuration. Use <code>PATCH /system/api-limits</code> instead.

patch/system/settings/conf

Request

Base URL
/ (relative, and the document was published on a file host, not at the API’s origin)
Auth
- HTTP bearer
- or OAuth 2
  Client credentials
  Token URL: https://login.cribl.cloud/oauth/token

Request body

Example request

{
  "backups": {},
  "pii": {},
  "rollback": {},
  "sni": {},
  "tls": {}
}

Response

The updated system settings.

countinteger required

Number of items returned in the items array.

Example response

{
  "items": [
    {
      "backups": {},
      "pii": {},
      "rollback": {},
      "sni": {},
      "tls": {}
    }
  ]
}

Changes

Sep 12, 20263816b6fddba1 Revision changes
- info
  added the new optional request property //
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  added the optional property //// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
Aug 14, 2026f24e21d4ad84 Revision changes
- breaking
  the response property // became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  the response property // became optional for the status
- info
  added the new optional request property /
- info
  the request property / became optional
- info
  the request property / became optional
- info
  the request property / became optional
- info
  the request property // became optional
- info
  the request property // became optional
- info
  the request property // became optional
- info
  the request property // became optional
- info
  the request property / became optional
- info
  the request property / became optional
- info
  the request property / became optional
- info
  the request property / became optional
- info
  the request property /// became optional
- info
  the request property /// became optional
- info
  the request property / became optional
- info
  the request property / became optional
- info
  the request property / became optional
- info
  the request property / became optional
- info
  the request property / became optional
- info
  added the optional property /// to the response with the status

Operation history (9 revisions)