---
title: "Add topic partitions"
method: PATCH
path: "/v1/topics-partitions"
tags: ["Topics"]
---

# Add topic partitions

`PATCH /v1/topics-partitions`

Add partitions to existing topics. Depending on the partitioning strategy used, this may impact ordering guarantees.

## Request body

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

## Response `200`

OK

- AddPartitionsToTopicsResponse
  - `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)