---
title: "Deletes global configuration items."
method: DELETE
path: "/configurations/{key_names}"
tags: ["Configurations"]
---

# Deletes global configuration items.

`DELETE /configurations/{key_names}`

## Request

- Base URL: `https://h2ogpte.genai.h2o.ai/api/v1`
- URL: `https://h2ogpte.genai.h2o.ai/api/v1/configurations/{key_names}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/h2o/apis/h2ogpte-rest-api/docs/configurations/:key_names/delete.ts> (a function with typed inputs; its response is checked against the schema)

Deletes global configuration items (to be used by admins only).

## Path parameters

- `key_names` string[], required

## Response `200`

Successful operation

- GlobalConfigurationItem[]
  - `key_name` string, required
  - `string_value` string, required
  - `value_type` string, required
  - `can_overwrite` boolean, required
  - `upper_bound` number
  - `is_public` boolean, required
  - `is_read_only` boolean
  - `is_encrypted` boolean
  - `description` string
  - `category` string
  - `needs_propagation` boolean: When true, mux resolves this key per-user (with role-priority overrides) and caches the resolved value for the duration of the global `config_cache_ttl_seconds` setting. The UI uses this flag to render an info icon explaining that changes take up to the cache-TTL seconds to propagate across all mux replicas.

## Other responses

- `400`: Bad request
- `401`: Unauthorized - Invalid or missing API key
- `default`: Unexpected error

---

[API](https://skmtc.dev/h2o/apis/h2ogpte-rest-api.md) - [All operations](https://skmtc.dev/h2o/apis/h2ogpte-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/h2o/apis/h2ogpte-rest-api/revisions/a82a117320f4?raw)