Skip to main content
DELETE
DELETE /v1/services/messagingServices/{id}

Delete a Messaging Service

Delete a messaging service by ID or fully qualified name. Supports soft delete (default), hard delete, and restore operations.

Delete by ID

id
string
required
UUID of the messaging service to delete.
recursive
boolean
default:"false"
Recursively delete all child topics.
hardDelete
boolean
default:"false"
Permanently delete the messaging service. If false, the service is soft-deleted and can be restored.

Delete by Name

Use DELETE /v1/services/messagingServices/name/{fqn} to delete by fully qualified name.
fqn
string
required
Fully qualified name of the messaging service (e.g., sample_kafka).
recursive
boolean
default:"false"
Recursively delete all child topics.
hardDelete
boolean
default:"false"
Permanently delete the messaging service.

Restore a Soft-Deleted Messaging Service

Use PUT /v1/services/messagingServices/restore to restore a soft-deleted messaging service.
id
string
required
UUID of the soft-deleted messaging service to restore.
DELETE /v1/services/messagingServices/{id}

Returns

Soft delete returns the messaging service object with deleted: true. Hard delete returns no content (204). Restore returns the restored messaging service object.

Error Handling