# Budget Members

This group of endpoints allows you to retrieve and manage budget member data, including listing budget members and fetching individual budget member details.

## List budget members

 - [GET /v1/businesses/{client_id}/budgets/{budget_id}/members](https://developer.letsweel.com/openapi/budget-members/listbudgetmembers.md): A budget member is a user who has been invited to a budget.

## Add budget member

 - [POST /v1/businesses/{client_id}/budgets/{budget_id}/members](https://developer.letsweel.com/openapi/budget-members/createbudgetmember.md): Adds a user (or pending invite) as a member of the budget. Provide
exactly one of user or invite. If an invite has already been
accepted, the response will contain user rather than invite.

Side effect: On budgets with per-member limits, adding a member
increases the budget's total limit and available amount by the new
member's reset_amount. Re-fetch the budget if you need the
updated totals. Shared-pot budgets are unaffected.

## Get budget member

 - [GET /v1/businesses/{client_id}/budgets/{budget_id}/members/{budget_member_id}](https://developer.letsweel.com/openapi/budget-members/getbudgetmember.md)

## Update budget member

 - [PATCH /v1/businesses/{client_id}/budgets/{budget_id}/members/{budget_member_id}](https://developer.letsweel.com/openapi/budget-members/updatebudgetmember.md): Updates a budget member's reset_amount. Only valid when the budget has
has_member_limits=true and reset_period is not NEVER.

Side effect: The budget's total limit changes by the difference
between the old and new reset_amount. The budget's available amount
is not touched — use topups
to change live balances.

## Remove budget member

 - [DELETE /v1/businesses/{client_id}/budgets/{budget_id}/members/{budget_member_id}](https://developer.letsweel.com/openapi/budget-members/deletebudgetmember.md): Deletes the budget member. If the member has an associated card,
the card is revoked asynchronously. A budget must retain at least one
member.

Side effect: On budgets with per-member limits, removing a member
reduces the budget's total limit and available amount by the member's
share.