Data Transformations - Delete Rule

Enterprise

This endpoint is part of Countly Enterprise. To get access, contact sales or compare versions. Existing customers can reach the support portal with questions.

Endpoint

/i/data-manager/transformation/delete

Overview

Deletes a transformation rule by ID.

Authentication

Pass api_key or auth_token as a query parameter, or send countly-token as a header. See Authentication.

Permissions

Requires data_manager_transformations Delete permission.

Request Parameters

Parameter	Type	Required	Description
app_id	String	Yes	Target app ID.
id	String	Yes	Transformation document ID.
api_key	String	Conditional	Required if auth_token is not provided.
auth_token	String	Conditional	Required if api_key is not provided.

Parameter Semantics

Field	Expected values	Behavior
id	Valid transformation document ID	The endpoint deletes only the matching rule for the current app_id.

Examples

/i/data-manager/transformation/delete?
  app_id=64f5c0d8f4f7ac0012ab3456&
  id=67b860e39f2d3e0012ab9c44

Response

Success Response

"Success"

Response Fields

Field	Type	Description
(root value)	String	Success when deletion completes.

Error Responses

• 500

{
  "result": "Error"
}

Behavior

Behavior Modes

Mode	Trigger	Processing Path	Response Shape
Delete	Always	Removes transformation by _id + app, invalidates cache.	Raw root string: "Success"

Impact on Other Data

• Deletes from countly.datamanager_transforms.
• Invalidates transformation cache for app.

Operational Considerations

• Deletion removes only rule definition; already transformed historical data is not rolled back by this endpoint.

Limitations

• Invalid IDs or DB failures are returned as generic 500 Error.

Related Endpoints

• Data Transformations - Read Rules
• Data Transformations - Create Rule

Implementation details

Audit & System Logs

Action	Trigger	Payload
dm-transformation-delete	After successful delete	{ id: "rule_id" }

Database Collections

Collection	Used for	Data touched by this endpoint
countly.datamanager_transforms	Transformation rule storage	Removes one rule document matching _id and app.
countly.systemlogs	Audit trail	Writes dm-transformation-delete with deleted rule ID.