v1

OpenAPI 3.1.0Proprietary2026-07-13197242444.9 KB

Topics

Create a new Kafka topic

post/topics

topic_namestring required

Kafka topic name

num_partitionsinteger

Number of partitions

replication_factorinteger nullable

Replication factor (defaults to broker count)

cleanup_policy'delete' | 'compact' | 'delete,compact'

min_insync_replicasinteger nullable

Minimum in-sync replicas

retention_msinteger nullable

Time to retain data in ms (-1 for unlimited)

retention_bytesinteger nullable

Max size on disk in bytes (-1 for unlimited)

max_message_bytesinteger nullable

Maximum message size in bytes

custom_configsobject nullable

Additional topic configs as key-value pairs

tagsstring[] nullable

Tag IDs to assign to the topic

Successful Response

idstring required

namestring required

prefixstring nullable

num_partitionsinteger required

replication_factorinteger required