---
type: api
title: Update proxy settings
description: > WARNING
url: https://www.elastic.co/elastic/docs-builder/docs/4641/api/doc/cloud-enterprise/v4/operation/operation-update-proxies-settings
resource: https://www.elastic.co/elastic/docs-builder/docs/4641/api/doc/cloud-enterprise/v4/operation/operation-update-proxies-settings
products:
  - Elastic Cloud Enterprise
---

# Update proxy settings

Authentication: required

## Paths

- `PATCH` `/platform/infrastructure/proxies/settings`

## Description

> WARNING
> This endpoint is deprecated and scheduled to be removed in the next major version.

Applies the settings as a patch. Only the fields that are referenced in the update are changed.

## Query string parameters

- `version` (string) — optional
  If specified, checks for conflicts against the version of the repository configuration (returned in 'x-cloud-resource-version' of the GET request)

## Request body

A JSON to merge with the existing settings

`application/json`

Type: `string`


## Responses

#### `200`

Returns the updated settings

`application/json`

- `expected_proxies_count` (integer · format: int32)
  Expected number of proxies
- `signature_secret` (string)
  Secret string for signature generation
- `signature_valid_for_millis` (integer · format: int64)
  Signature validity in milliseconds
- `http_settings` (object)
  > WARNING
> This object is deprecated and scheduled to be removed in the next major version.
  - `disconnected_cutoff` (integer · format: int64)
    Cutoff interval after disconnection in milliseconds
  - `minimum_proxy_services` (integer · format: int32)
    Minimum number of proxy instances
  - `sso_settings` (object)
    > WARNING
> This object is deprecated and scheduled to be removed in the next major version.
    - `max_age` (integer · format: int64)
      Maximum age of single-sign-on token in milliseconds
    - `sso_secret` (string)
      Secret string for single-sign-on
    - `cookie_name` (string)
      Name of the HTTP cookie used for single-sign-on
    - `dont_log_requests` (boolean)
      If true, don't log requests
    - `default_redirect_path` (string)
      Default path where users are redirected after a successful single-sign-on
    - `maintenance_bypass_cookie_name` (string)
      Name of the cookie that bypasses maintenance
  - `dashboards_base_url` (string)
    Base URL for the dashboard
  - `cookie_secret` (string)
    Secret string for the HTTP cookie
  - `user_cookie_key` (string)
    User key for the HTTP cookie
#### `409`

There is a version conflict. (code: `proxies.version_conflict`)

`application/json`

- `errors` (object[])
  A list of errors that occurred in the failing request
  - `code` (string)
    A structured code representing the error type that occurred
  - `message` (string)
    A human readable message describing the error that occurred
  - `fields` (string[])
    If the error can be tied to a specific field or fields in the user request, this lists those fields
##### Response headers

- `x-cloud-error-codes` (enum)
  The error codes associated with the response

## Code examples

#### curl

```curl
curl -X PATCH "${API_URL}/platform/infrastructure/proxies/settings" \
  -u "${USERNAME}:${PASSWORD}" \
  -H "Content-Type: application/json" \
  -d '"string"'
```

## Response examples

#### 200

`application/json`

Generated from the API spec. Values are representative. Unions use the first variant; deeply nested or large bodies may omit fields.

```json
{
  "expected_proxies_count": 0,
  "signature_secret": "string",
  "signature_valid_for_millis": 0,
  "http_settings": {
    "disconnected_cutoff": 0,
    "minimum_proxy_services": 0,
    "sso_settings": {
      "max_age": 0,
      "sso_secret": "string",
      "cookie_name": "string",
      "dont_log_requests": false,
      "default_redirect_path": "string",
      "maintenance_bypass_cookie_name": "string"
    },
    "dashboards_base_url": "string",
    "cookie_secret": "string",
    "user_cookie_key": "string"
  }
}
```

#### 409

`application/json`

Generated from the API spec. Values are representative. Unions use the first variant; deeply nested or large bodies may omit fields.

```json
{
  "errors": [
    {
      "code": "string",
      "message": "string",
      "fields": [
        "string"
      ]
    }
  ]
}
```