---
title: "Set topic partitions"
method: PUT
path: "/v1/topics-partitions"
tags: ["Topics"]
---

# Set topic partitions

`PUT /v1/topics-partitions`

Set partition counts for existing topics. New value must be equal to or larger than the current count of partitions in the topic. All topics will have the same final count of partitions. Depending on the partitioning strategy used, this may impact ordering guarantees.

## Request body

- SetPartitionsToTopicsRequest
  - `partition_count` integer — The number of partitions to set for the topics.
  - `topic_names` string[] — The topic names.
  - `validate_only` boolean — Validate the request only, do not execute it.

## Response `200`

OK

- SetPartitionsToTopicsResponse
  - `statuses` AlterTopicPartitionStatus[] — The status of the operation for each topic.
    - `error` string — The error if any.
    - `success` boolean — Whether the operation was successful.
    - `topic_name` string — The topic name.

## 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)