Make it my default (HH-10). Not an archived household (`household_archived`).
Required scope: `households:manage` (personal access tokens; sessions have every scope).
Required scope: households:manage (personal access tokens; sessions have every scope).
Authorization
bearerAuth Authorization: Bearer <token>: a mobile session token, or a personal access token
(srp_…) created in Account → API tokens (DEV-1).
Personal access tokens:
- Act as their user. The household comes from
X-SpendRock-Household, else the user's default. - Carry scopes (DEV-2), and each operation's description names the one it needs:
budget:read/budget:write(months, groups, items, funds, favorites, harvest),transactions:read/transactions:write(transactions, merchant suggestions),households:read/households:manage(households, members, invites),account:read/account:write(me, settings). A write scope includes its read scope. A call outside the token's scopes gets 403insufficient_scope, with the needed scope indetails.required_scope. - Can't manage tokens or passwords (403
session_required). - May expire (401
unauthenticatedafterwards). - Are rate-limited (DEV-3): 120 requests/minute per token with bursts up to 120. Every
response carries
X-RateLimit-Limit,X-RateLimit-Remaining, andX-RateLimit-Reset(seconds until the bucket is full again); over the limit the answer is 429rate_limitedwithRetry-After(seconds). Limits are kept per server instance, so they're approximate.
Sessions (web cookie or mobile bearer) have every scope and aren't limited this way. Cross-origin browser calls (CORS, for the API docs playground) must use a bearer token; cookies are never accepted cross-origin.
In: header
Path Parameters
ULID.
^[0-9A-HJKMNP-TV-Z]{26}$Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/households/01J8Z3N4Q5R6S7T8V9W0X1Y2Z3/default"Delete for all members (owner only; never a personal household). A soft delete; members whose default it was fall back to their personal household (HH-18). DELETE
Required scope: `households:manage` (personal access tokens; sessions have every scope).
Hide it from my lists (per user; never deletes anything; HH-19). Not my default (`default_household`), not my last non-archived one (`last_household`). POST
Required scope: `households:manage` (personal access tokens; sessions have every scope).