COconfluent
Topic (v3)

Create Topic

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. Note that when dry-run mode is being used the response status would be 200 OK instead of 201 Created.

post/kafka/v3/clusters/{cluster_id}/topics

Request

  • Base URL
    https://pkc-00000.region.provider.confluent.cloud
  • URL
    https://pkc-00000.region.provider.confluent.cloud/kafka/v3/clusters/{cluster_id}/topics
  • Auth
    • HTTP basic
    • or OAuth 2
      Client credentials
      Token URL: https://api.confluent.cloud/sts/v1/oauth2/token

Request body

topic_namestring required
partitions_countinteger
replication_factorinteger
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

No recorded changes to this operation across all 7 revisions of this API.