Delete a Kafka Topic

Allows you to delete a specific Kafka topic from a specified Kafka cluster.

Endpoint

DELETE /clusters/{clusterId}/topics/{topicId}

The DELETE /clusters/{clusterId}/topics/{topicId} endpoint deletes the Kafka topic specified by topicId from the Kafka cluster identified by clusterId. Upon successful deletion request, the endpoint returns a 202 Accepted status code, indicating that the topic deletion process has been initiated.

Use this endpoint carefully as it permanently removes the Kafka topic and its associated data. Ensure appropriate permissions and safeguards are in place before executing this operation.

Request

curl -X 'DELETE' \
  'https://kafka.de-txl.ionos.com/clusters/e69b22a5-8fee-56b1-b6fb-4a07e4205ead/topics/ae085c4c-3626-5f1d-b4bc-cc53ae8267ce' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $Token'

Request Header Parameters

To make authenticated requests to the API, the following fields are mandatory in the request header:

Header Parameters	Required	Type	Description
Accept	yes	string	Set this to application/json.
Authorization	yes	string	Provide a header value as Bearer followed by your token.

Request Path Parameters

Path Parameters	Required	Type	Description
clusterId	Yes	string	The UUID of the Kafka cluster. Example: e69b22a5-8fee-56b1-b6fb-4a07e4205ead
topicId	Yes	string	The UUID of the Kafka topic. Example: ae085c4c-3626-5f1d-b4bc-cc53ae8267ce

Response

202 Accepted

The request to delete the topic was successful.