Delete a datasource entity

DELETE 
/datasources/:datasource_id/entities/:entity_id

Deletes a shared entity. Requires at least edit permission on the path datasource (else AUTH-1012). Entity must belong to the path datasource. Advanced dedicated entity_id equal to datasource_id cannot be deleted (GE-1034). Supports instances, functions, and kafka-cluster entity types. Not idempotent when already deleted.

Request

Responses

200

Deletion accepted. Typical Message values: "Successfully deleted entity", "Successfully triggered entity deletion", "Successfully triggered entity deletion and is running in background" (Advanced with ClusterArn).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

400

Validation or authorization failure. Body is {"Message": " - "}. Common codes: AUTH-1012 (no edit access), IPV-1045 (missing entity or wrong datasource), GE-1034 when raised as InvalidInput (e.g. Bulkload active DMS tasks blocking delete).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

500

Backend failure. Body is {"Message": " - "}. Common codes: GE-1034 (busy status, active MSK/Streams dependents, dedicated Advanced cannot delete), DTSC-1007 (schedule cleanup), GE-1020 / DB-1003 / GE-1075 (persist or S3 cleanup).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers