COconfluentinc
Topic (v3)

Create Topic

Changed on

Generally Available

Create a topic. Also supports a dry-run mode that only validates whether the topic creation would succeed if the validate_only request property is explicitly specified and set to true.

post/clusters/{cluster_id}/topics

Request

  • Base URL
    http://localhost:8082/v3
  • URL
    http://localhost:8082/v3/clusters/{cluster_id}/topics
  • Auth
    none declared

Request body

topic_namestring required
partitions_countinteger
replication_factorinteger
replicas_assignmentsobject
validate_onlyboolean

Response

The created topic.

kindstring required
cluster_idstring required
topic_namestring required
is_internalboolean required
replication_factorinteger required
partitions_countinteger required
authorized_operationsstring[]

Changes

  • v325e5259d1722Revision changes
    • breaking

      the request property type changed from array to object

    • breaking

      removed the media type text/plain for the response with the status

    • info

      api operation id createKafkaV3Topic removed and replaced with createKafkaTopic

    • info

      added the non-success response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • v31be42847ed21Revision changes
    • breaking

      the request property type changed from object to array

    • warning

      removed the optional property / from the response with the status

    • warning

      removed the optional property / from the response with the status

    • info

      api operation id createKafkaTopic removed and replaced with createKafkaV3Topic

    • info

      added the media type text/plain for the response with the status

    • info

      removed the non-success response with the status