---
title: "Replace the org's fleet settings"
method: PUT
path: "/api/{org_id}/fleet/settings"
tags: ["Fleet"]
---

# Replace the org's fleet settings

`PUT /api/{org_id}/fleet/settings`

## Request

- Base URL: `https://api.openobserve.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openobserve.ai/api/{org_id}/fleet/settings`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/:org_id/fleet/settings/put.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `org_id` string, required

## Request body

- Settings: Organization fleet settings; `PUT` replaces every field.
  - `fleet_defaults` FleetSettings: Per-fleet overrides; `None` inherits the organization default.
    - `gate` GateSettings: The verification gate: wait `observe_secs`, then measure over `window_secs`.
      - `observe_secs` integer, required
      - `pass_percent` integer, required
      - `window_secs` integer, required
    - `heartbeat_interval_secs` integer, nullable
    - `offline_heartbeats` integer, nullable: A collector is offline after this many missed heartbeats.
    - `offline_ratio_percent` integer, nullable
    - `phase_timeout_secs` integer, nullable
    - `retention_days` integer, nullable: Offline collectors are removed after this many days; 0 keeps them forever.
  - `restricted_components` string[]
  - `target_collector_version` string, nullable: A null target means the built-in default.

## Response `200`

The settings as stored

- Settings: Organization fleet settings; `PUT` replaces every field.
  - `fleet_defaults` FleetSettings: Per-fleet overrides; `None` inherits the organization default.
    - `gate` GateSettings: The verification gate: wait `observe_secs`, then measure over `window_secs`.
      - `observe_secs` integer, required
      - `pass_percent` integer, required
      - `window_secs` integer, required
    - `heartbeat_interval_secs` integer, nullable
    - `offline_heartbeats` integer, nullable: A collector is offline after this many missed heartbeats.
    - `offline_ratio_percent` integer, nullable
    - `phase_timeout_secs` integer, nullable
    - `retention_days` integer, nullable: Offline collectors are removed after this many days; 0 keeps them forever.
  - `restricted_components` string[]
  - `target_collector_version` string, nullable: A null target means the built-in default.

## Other responses

- `400`: Invalid
- `403`: Forbidden

---

[API](https://skmtc.dev/openobserve/apis/openobserve-api-http.md) - [All operations](https://skmtc.dev/openobserve/apis/openobserve-api-http/llms.txt) - [OpenAPI document](https://skmtc.dev/openobserve/apis/openobserve-api-http/revisions/0529b8a10252?raw)