---
title: "Update settings"
method: PUT
path: "/api/fleet/settings"
tags: ["Fleet internals"]
---

# Update settings

`PUT /api/fleet/settings`

**Spaces method and path for this operation:**

<div><span class="operation-verb put">put</span>&nbsp;<span class="operation-path">/s/{space_id}/api/fleet/settings</span></div>

Refer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.

Update the global Fleet settings.<br/><br/>[Required authorization] Route required privileges: fleet-settings-all.

## Headers

- `kbn-xsrf` string, required

## Request body

- object
  - `additional_yaml_config` string
  - `delete_unenrolled_agents` object
    - `enabled` boolean, required
    - `is_preconfigured` boolean, required
  - `has_seen_add_data_notice` boolean
  - `integration_knowledge_enabled` boolean
  - `kibana_ca_sha256` string
  - `kibana_urls` string[]
  - `prerelease_integrations_enabled` boolean

## Response `200`

Successful response

- object
  - `item` object, required
    - `action_secret_storage_requirements_met` boolean
    - `delete_unenrolled_agents` object
      - `enabled` boolean, required
      - `is_preconfigured` boolean, required
    - `download_source_auth_secret_storage_requirements_met` boolean
    - `has_seen_add_data_notice` boolean
    - `id` string
    - `ilm_migration_status` object
      - `logs` 'success' | 'null', nullable
      - `metrics` 'success' | 'null', nullable
      - `synthetics` 'success' | 'null', nullable
    - `integration_knowledge_enabled` boolean
    - `output_secret_storage_requirements_met` boolean
    - `preconfigured_fields` string[]
    - `prerelease_integrations_enabled` boolean
    - `secret_storage_requirements_met` boolean
    - `ssl_secret_storage_requirements_met` boolean
    - `use_space_awareness_migration_started_at` string, nullable
    - `use_space_awareness_migration_status` 'pending' | 'success' | 'error'
    - `version` string

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[API](https://skmtc.net/elastic/apis/kibana-apis.md) · [All operations](https://skmtc.net/elastic/apis/kibana-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elastic/kibana-apis/versions/531c9e2a7d23/schema)