---
title: "Changes to Create Topic"
method: POST
path: "/clusters/{cluster_id}/topics"
---

# Changes to Create Topic

`POST /clusters/{cluster_id}/topics`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 23 of 69 revisions.

- **2023-08-08** (v3) `25e5259d1722`: 2 breaking, 4 info
- **2023-08-08** (v3) `1be42847ed21`: 1 breaking, 2 warning, 3 info
- **2023-03-13** (v3) `4a6390846d5c`: 1 breaking
- **2023-03-10** (v3) `bb1cdf42f052`: 1 breaking, 2 info
- **2023-03-08** (v3) `fc2720a3b446`: 2 info
- **2023-03-08** (v3) `125174a361e4`: 2 info
- **2023-03-02** (v3) `0bf677c1cb67`: 1 breaking, 1 warning
- **2022-12-06** (v3) `1539b3a4a2df`: 2 info
- **2022-03-22** (v3) `7500cc59fcff`: 6 info
- **2022-03-22** (v3) `fb570c3144de`: 1 info
- **2022-03-22** (v3) `0b87d328c664`: 1 breaking, 6 info
- **2022-01-18** (v3) `242a6e383b71`: 6 info
- **2022-01-18** (v3) `fbdd72178c66`: 6 info
- **2021-09-08** (v3) `2d4f120a2079`: 3 info
- **2021-09-01** (v3) `fc95920a3a26`: 3 info
- **2021-07-12** (v3) `9d6bc272cc45`: 1 info
- **2021-07-07** (v3) `031b7043e56a`: 1 breaking
- **2021-06-15** (v3) `d6fa9a3f19d9`: 1 info
- **2021-06-15** (v3) `4de8ce028b2e`: 1 breaking
- **2021-04-27** (v3) `d12053b3b4a6`: 1 info
- **2021-02-08** (v3) `465b17368432`: 3 info
- **2021-02-08** (v3) `24388fe7ebea`: 2 breaking, 1 warning
- **2021-01-21** (v3) `f6853db47a86`: 3 info

## Changes

- **2023-08-08** (v3) `25e5259d1722`: 2 breaking, 4 info
  - the `replicas_assignments` request property type changed from `array` to `object`
  - removed the media type `text/plain` for the response with the status `400`
  - api operation id `createKafkaV3Topic` removed and replaced with `createKafkaTopic`
  - added the non-success response with the status `403`
  - added the optional property `allOf[subschema #2]/authorized_operations` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/authorized_operations` to the response with the `201` status
- **2023-08-08** (v3) `1be42847ed21`: 1 breaking, 2 warning, 3 info
  - the `replicas_assignments` request property type changed from `object` to `array`
  - removed the optional property `allOf[subschema #2]/authorized_operations` from the response with the `200` status
  - removed the optional property `allOf[subschema #2]/authorized_operations` from the response with the `201` status
  - api operation id `createKafkaTopic` removed and replaced with `createKafkaV3Topic`
  - added the media type `text/plain` for the response with the status `400`
  - removed the non-success response with the status `403`
- **2023-03-13** (v3) `4a6390846d5c`: 1 breaking
  - the `replicas_assignments` request property type changed from `array` to `object`
- **2023-03-10** (v3) `bb1cdf42f052`: 1 breaking, 2 info
  - removed the media type `text/plain` for the response with the status `400`
  - api operation id `createKafkaV3Topic` removed and replaced with `createKafkaTopic`
  - added the non-success response with the status `403`
- **2023-03-08** (v3) `fc2720a3b446`: 2 info
  - added the optional property `allOf[subschema #2]/authorized_operations` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/authorized_operations` to the response with the `201` status
- **2023-03-08** (v3) `125174a361e4`: 2 info
  - added the new optional request property `validate_only`
  - added the success response with the status `200`
- **2023-03-02** (v3) `0bf677c1cb67`: 1 breaking, 1 warning
  - removed the success response with the status `200`
  - removed the request property `validate_only`
- **2022-12-06** (v3) `1539b3a4a2df`: 2 info
  - added the new optional request property `validate_only`
  - added the success response with the status `200`
- **2022-03-22** (v3) `7500cc59fcff`: 6 info
  - api operation id `createKafkaV3Topic` was added
  - api tag `Topic (v3)` added
  - api tag `Topic` removed
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `429`
- **2022-03-22** (v3) `fb570c3144de`: 1 info
  - added the required property `allOf[subschema #2]/partitions_count` to the response with the `201` status
- **2022-03-22** (v3) `0b87d328c664`: 1 breaking, 6 info
  - removed the required property `allOf[subschema #2]/partitions_count` from the response with the `201` status
  - api operation id `createKafkaV3Topic` removed and replaced with ``
  - api tag `Topic` added
  - api tag `Topic (v3)` removed
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `429`
- **2022-01-18** (v3) `242a6e383b71`: 6 info
  - api operation id `createKafkaV3Topic` was added
  - api tag `Topic (v3)` added
  - api tag `Topic` removed
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `429`
- **2022-01-18** (v3) `fbdd72178c66`: 6 info
  - api operation id `createKafkaV3Topic` removed and replaced with ``
  - api tag `Topic` added
  - api tag `Topic (v3)` removed
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `429`
- **2021-09-08** (v3) `2d4f120a2079`: 3 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `429`
- **2021-09-01** (v3) `fc95920a3a26`: 3 info
  - api operation id `createKafkaV3Topic` was added
  - api tag `Topic (v3)` added
  - api tag `Topic` removed
- **2021-07-12** (v3) `9d6bc272cc45`: 1 info
  - added the required property `allOf[subschema #2]/partitions_count` to the response with the `201` status
- **2021-07-07** (v3) `031b7043e56a`: 1 breaking
  - removed the required property `allOf[subschema #2]/partitions_count` from the response with the `201` status
- **2021-06-15** (v3) `d6fa9a3f19d9`: 1 info
  - added the required property `allOf[subschema #2]/partitions_count` to the response with the `201` status
- **2021-06-15** (v3) `4de8ce028b2e`: 1 breaking
  - removed the required property `allOf[subschema #2]/partitions_count` from the response with the `201` status
- **2021-04-27** (v3) `d12053b3b4a6`: 1 info
  - added the required property `allOf[subschema #2]/partitions_count` to the response with the `201` status
- **2021-02-08** (v3) `465b17368432`: 3 info
  - added the new optional request property `replicas_assignments`
  - the request property `partitions_count` became optional
  - the request property `replication_factor` became optional
- **2021-02-08** (v3) `24388fe7ebea`: 2 breaking, 1 warning
  - the request property `partitions_count` became required
  - the request property `replication_factor` became required
  - removed the request property `replicas_assignments`
- **2021-01-21** (v3) `f6853db47a86`: 3 info
  - added the new optional request property `replicas_assignments`
  - the request property `partitions_count` became optional
  - the request property `replication_factor` became optional

---

[Operation](https://skmtc.dev/confluentinc/apis/rest-admin-api/docs/clusters/:cluster_id/topics/post.md) - [API](https://skmtc.dev/confluentinc/apis/rest-admin-api.md) - [Page](https://skmtc.dev/confluentinc/apis/rest-admin-api/changes/clusters/:cluster_id/topics/post)
