Delete Rule

DELETE /api/v1/rules/:id

Deletes a rule permanently.

Path Parameters

ParameterTypeDescription
idstringRule 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:

  1. The rule is permanently removed from the database
  2. Future transactions will not be matched by this rule
  3. Existing transactions are not affected (their categorization remains)
  4. 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

CodeDescription
401Invalid or missing API credentials
403API key lacks rules:delete permission
404Rule not found