Delete Rule
DELETE /api/v1/rules/:id
Deletes a rule permanently.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
| id | string | Rule ID |
Example Request
curl -X DELETE "https://statements.finopsbricks.com/api/v1/rules/rule123xyz" \
-H "api-key: fob_stm_xxxxxxxxxxxx" \
-H "api-secret: xxxxxxxxxxxxxxxx"
Response
Returns 204 No Content on success.
What Happens
When a rule is deleted:
- The rule is permanently removed from the database
- Future transactions will not be matched by this rule
- Existing transactions are not affected (their categorization remains)
- This action cannot be undone
Alternative: Disable Instead
If you might need the rule again, consider disabling it instead of deleting:
curl -X PUT "https://statements.finopsbricks.com/api/v1/rules/rule123xyz" \
-H "api-key: fob_stm_xxxxxxxxxxxx" \
-H "api-secret: xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"enabled": false}'
Errors
| Code | Description |
|---|---|
| 401 | Invalid or missing API credentials |
| 403 | API key lacks rules:delete permission |
| 404 | Rule not found |