v50

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-0193273218.8 KB

Topics

Create topic

Create a topic.

post/v1/topics

Query parameters

validate_onlyboolean

If true, makes this request a dry run; everything is validated but no topics are actually created.

Request body

namestring

Name of topic.

partition_countinteger nullable

The number of partitions to give the topic. If specifying partitions manually (see replica_assignments), set to -1. Or, to use the cluster default partition count, set to null.

replication_factorinteger nullable

The number of replicas every partition must have. If specifying partitions manually (see replica_assignments), set to -1. Or, to use the cluster default replication factor, set to null.

Response

Topic created

partition_countinteger

The number of partitions created for the topic. This field has a default value of -1, which may be returned if the broker does not support v5+ of this request which added support for returning this information.

replication_factorinteger

The number of replicas per topic partition. This field has a default of -1, which may be returned if the broker does not support v5+ of this request which added support for returning this information.

topic_namestring

Name of topic.