REredpanda-data
Topics

Create topic

Changed on

Create a topic.

post/v1/topics

Request

  • Base URL
    https://{dataplane_api_url}
  • Auth
    OAuth 2
    Implicit: https://auth.prd.cloud.redpanda.com/oauth/authorize

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.

Changes