Penny Docs
Rules

Delete Rule

DELETE
/v1/households/{household_id}/rules/{rule_id}

Deletes a household rule so it is no longer applied to transactions.

Changes previously made by the rule, including assigned categories and tags, are retained. Returns 204 with no response body, or rule_not_found if the rule is already deleted or unavailable in this household.

Authorization

PersonalApiToken
AuthorizationBearer <token>

Use your personal API token (penny_pat_…) as the bearer credential. Enter the token only; the client adds the Bearer prefix. Read-only tokens permit read requests. Read/write tokens remain limited by your current household membership and role. See https://penny.finance/docs/api#authentication for setup.

In: header

Path Parameters

household_id*Household Id
rule_id*Rule Id

Response Body

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/households/string/rules/string"
Empty

Get Rule GET

Retrieves an active household rule with its priority, matching conditions, and actions. Returns rulenotfound if the rule is deleted or does not belong to…

Update Rule PUT

Replaces all matching conditions and actions of an existing rule while preserving its position in the priority order. Omitted fields reset to their schema…