Penny Docs
Categories

Update Category Group

PUT
/v1/households/{household_id}/category-groups/{group_id}

Renames a category group and returns the updated group. Its type and existing category assignments are preserved.

The new name must be unique within the household. Returns category_group_not_found if the group does not belong to 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
group_id*Group Id

Request Body

application/json

name*Name
Lengthlength <= 255

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/category-groups/string" \  -H "Content-Type: application/json" \  -d '{    "name": "Everyday Expenses"  }'
{  "id": "Cg2mV7pL4zXe",  "name": "Everyday Expenses",  "group_type": "income"}

Delete Category Group DELETE

Permanently deletes a category group and leaves its categories ungrouped. The categories, their types, and their transaction assignments are retained.…

List Merchants GET

Lists all active merchants in the household, including their display images and counts of visible transactions and recurring series. The response is not…