---
title: "Update topic configuration"
method: PATCH
path: "/v1/topics/{topic_name}/configurations"
tags: ["Topics"]
---

# Update topic configuration

`PATCH /v1/topics/{topic_name}/configurations`

Update a subset of the topic configurations.

## Path parameters

- `topic_name` string, required

## Request body

- UpdateConfiguration[]
  - `name` string — A topic-level config key (e.g. `segment.bytes`).
  - `operation` 'CONFIG_ALTER_OPERATION_SET' | 'CONFIG_ALTER_OPERATION_DELETE' | 'CONFIG_ALTER_OPERATION_APPEND' | 'CONFIG_ALTER_OPERATION_SUBTRACT'
  - `value` string, nullable — A topic-level config value (e.g. 1073741824).

## Response `200`

OK

- UpdateTopicConfigurationsResponse
  - `configurations` Configuration[] — Topic's complete set of configurations after applying this partial patch.
    - `config_synonyms` ConfigSynonym[] — If no config value is set at the topic level, it will inherit the value set at the broker or cluster level. `name` is the corresponding config key whose value is inherited. `source` indicates whether the inherited config is default, broker, etc.
      - `name` string
      - `source` 'CONFIG_SOURCE_DYNAMIC_TOPIC_CONFIG' | 'CONFIG_SOURCE_DYNAMIC_BROKER_CONFIG' | 'CONFIG_SOURCE_DYNAMIC_DEFAULT_BROKER_CONFIG' | 'CONFIG_SOURCE_STATIC_BROKER_CONFIG' | 'CONFIG_SOURCE_DEFAULT_CONFIG' | 'CONFIG_SOURCE_DYNAMIC_BROKER_LOGGER_CONFIG'
      - `value` string, nullable
    - `documentation` string, nullable — Config documentation.
    - `name` string — A topic-level config key (e.g. `segment.bytes`).
    - `read_only` boolean — Whether the config is read-only, or is dynamic and can be altered.
    - `sensitive` boolean — Whether this is a sensitive config key and value.
    - `source` 'CONFIG_SOURCE_DYNAMIC_TOPIC_CONFIG' | 'CONFIG_SOURCE_DYNAMIC_BROKER_CONFIG' | 'CONFIG_SOURCE_DYNAMIC_DEFAULT_BROKER_CONFIG' | 'CONFIG_SOURCE_STATIC_BROKER_CONFIG' | 'CONFIG_SOURCE_DEFAULT_CONFIG' | 'CONFIG_SOURCE_DYNAMIC_BROKER_LOGGER_CONFIG'
    - `type` 'CONFIG_TYPE_BOOLEAN' | 'CONFIG_TYPE_STRING' | 'CONFIG_TYPE_INT' | 'CONFIG_TYPE_SHORT' | 'CONFIG_TYPE_LONG' | 'CONFIG_TYPE_DOUBLE' | 'CONFIG_TYPE_LIST' | 'CONFIG_TYPE_CLASS' | 'CONFIG_TYPE_PASSWORD'
    - `value` string, nullable — A topic-level config value (e.g. 1073741824).

## Other responses

- `401` — Unauthenticated.
- `404` — Not Found
- `500` — Internal Server Error. Reach out to support.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/redpanda-data/apis/redpanda-cloud-data-plane-api.md) · [All operations](https://skmtc.net/redpanda-data/apis/redpanda-cloud-data-plane-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/redpanda-data/redpanda-cloud-data-plane-api/versions/2917b4dd86f7/schema)