Delete Token
Needs a signed-in session: personal access tokens get 403 `session_required`.
Needs a signed-in session: personal access tokens get 403 session_required.
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 DELETE "https://example.com/tokens/01J8Z3N4Q5R6S7T8V9W0X1Y2Z3"Create a personal access token (DEV-1, DEV-2) POST
`scopes` defaults to every scope (full access) when omitted. `expires_in_days` omitted means the token never expires; an expired token gets 401 `unauthenticated`. Needs a signed-in session: personal access tokens get 403 `session_required`.
Which months have budgets (for the month picker, NAV-2) GET
Required scope: `budget:read` (personal access tokens; sessions have every scope).