Data Transformations - Delete Rule
Ⓔ Enterprise Only This API is available exclusively in Countly Enterprise.
Endpoint
/i/data-manager/transformation/delete
Overview
Deletes a transformation rule by ID.
Authentication
Countly API supports three authentication methods:
- API key query parameter:
api_key=YOUR_API_KEY - Auth token query parameter:
auth_token=YOUR_AUTH_TOKEN - Auth token header:
countly-token: YOUR_AUTH_TOKEN
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. |
Response
Success Response
"Success"
Response Fields
| Field | Type | Description |
|---|---|---|
(root value) | String | Success when deletion completes. |
Error Responses
500
{
"result": "Error"
}
Behavior/Processing
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.
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. |
Examples
/i/data-manager/transformation/delete?
app_id=64f5c0d8f4f7ac0012ab3456&
id=67b860e39f2d3e0012ab9c44
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
Last Updated
2026-02-16