Penny Docs
Tags

Update Tag

PUT
/v1/households/{household_id}/tags/{tag_id}

Replaces a tag's name and color and returns the updated tag. Existing transaction assignments are retained.

Supply both fields, using color: null to clear the custom color. The name must remain unique among active household tags.

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
tag_id*Tag Id

Request Body

application/json

name*Name
Lengthlength <= 255
color?|null

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/v1/households/string/tags/string" \  -H "Content-Type: application/json" \  -d '{    "name": "Work meals"  }'
{  "id": "Tg8qN1cK5rWd",  "name": "Work meals",  "color": "#6D5BD0",  "transaction_count": 12}

Delete Tag DELETE

Deletes a tag and removes it from every associated transaction, including transactions on deleted accounts. The transactions themselves are retained. Also…

List Rules GET

Lists the household's active transaction rules in priority order, highest priority first, with their conditions and actions. Use this order when presenting…