Update the accounts of a household
PUT/v1/households/:id/accounts
Replaces the accounts of the household with the given ID with the accounts in the request body, and returns the household's active accounts after the change, in order of account ID. The household's accounts you leave out are left with no household. An account ID that is not one of your firm's accounts is skipped. If your firm has no household with that ID, the response is 404 and nothing changes.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 429
The household's accounts after the change.
id is not a whole number, or the request body is not an array of whole numbers of at least 1.
The access token is missing, invalid, or expired.
The access token does not have the write:household scope or the write:crm scope.
Your firm has no household with that ID.
An account that the request would move to another household or remove from its household is the payer account of a household group. Nothing changes. message names each such account and its household group, and details.payerAccounts lists them. Designate another payer account or clear the payer account of the household group first.
Too many requests. Wait the number of seconds in the Retry-After-per-person header (script-audience tokens) or the Retry-After header (other requests) before you retry. See Rate limit.