Penny Docs
Merchants

Delete Merchant Image

DELETE
/v1/households/{household_id}/merchants/{merchant_id}/image

Removes a merchant's custom image so image_url falls back to default_image_url, which may be null.

Returns 204 with no response body on success, or no_image if the merchant has no custom upload. A default image alone cannot be removed through this endpoint.

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
merchant_id*Merchant Id

Response Body

application/json

application/json

application/json

application/json

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

Update Merchant PUT

Replaces a merchant's name and website and returns the updated merchant. Changes are reflected wherever that merchant is displayed in the household. Supply…

Upload Merchant Image PUT

Uploads or replaces a merchant's custom image and returns its display URL. The custom image takes precedence over any default merchant image. Send a JPEG,…